CADMATIC 

Plant/Outfitting
CADMATIC Information Management
CADMATIC Web API

Release Notes 2021T3R6

Copyright © 2022 by CADMATIC
All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means without the express
written permission of the publisher.
CADMATIC is a registered trademark of CADMATIC Oy. All other trademarks are property of their respective owners.

FINLAND SWEDEN ESTONIA THE NETHERLANDS CHINA HUNGARY INDIA ITALY RUSSIA SINGAPORE UAE SOUTH KOREA

www.cadmatic.com | [email protected] | [email protected]

CADMATIC SOFTWARE SOLUTIONS

Contents
CADMATIC 2021T3R6 Release Notes 4
1. CADMATIC Plant/Outfitting 5
1.1. New Features in 2021T3 5
1.2. Improvements in 2021T3 10
1.3. Improvements in 2021T3R4 15
1.4. Improvements in 2021T3R5 16
1.5. Bug Fixes in 2021T3 16
1.6. Bug Fixes in 2021T3R4 20
1.7. Bug Fixes in 2021T3R5 21
1.8. Bug Fixes in 2021T3R6 22
2. CADMATIC Information Management 23
2.1. CADMATIC eShare 23
2.1.1. New Features in 2021T3 23
2.1.2. Improvements in 2021T3 25
2.1.3. Improvements in 2021T3R2 26
2.1.4. Bug Fixes in 2021T3 27
2.1.5. Bug Fixes in 2021T3R2 28
2.2. CADMATIC eGo 29
2.2.1. Improvements in 2021T3 29
2.2.2. Bug Fixes in 2021T3 29
2.2.3. Bug Fixes in 2021T3R2 29
2.3. CADMATIC eBrowser 29
2.3.1. New Features in 2021T3 29
2.3.2. Improvements in 2021T3 30
2.3.3. Bug Fixes in 2021T3 31
3. CADMATIC Web API 32
3.1. New Features in 2021T3 32
3.2. Improvements in 2021T3 32
3.3. Bug Fixes in 2021T3 33
3.4. Bug Fixes in 2021T3R2 33
3.5. Bug Fixes in 2021T3R4 33
4. Installation Notes 34
4.1. Version Compatibility 34
4.2. CADMATIC Plant/Outfitting Upgrade Notes 35
4.2.1. Preparations for Upgrading from Version 6.0.X 35
4.2.2. Preparations for Upgrading from Version 6.1.X or Newer 36
4.2.3. Preparations for Upgrading from Version Older than 2019T3 36
4.2.3.1. GUID-based Plant Modeller Object IDs 36
4.2.3.2. Same Piping Objects in Plant Modeller and COS 38
4.2.3.3. Hole Requests Have Their Own Object Type 42
CADMATIC SOFTWARE SOLUTIONS

4.2.3.4. EBMs Require Updated Information Management Products 42

4.2.4. Upgrading the License Server 42
4.2.5. Upgrading the COS Server 42
4.2.6. Upgrading the Applications 43
4.2.7. Converting Projects 43
4.2.8. User Areas After the Upgrade 44
4.2.9. Converting Documents 44
4.3. CADMATIC eShare Upgrade Notes 44
4.3.1. Changes in IFC Importer 45
4.3.2. Changes in eShare App Installer 46
4.4. CADMATIC eBrowser Upgrade Notes 46
5. Upgrading to the New Drafting Platform 47
5.1. Before Version Upgrade 47
5.2. After Version Upgrade 48
5.2.1. New Configuration Tools for Administrators 48
5.2.2. Changes in Configuration Tools 49
5.2.3. Converting Documents 50
5.2.4. Changes in Menus 51
5.2.5. Changes in Scripting 51
5.3. Known Problems and Limitations 54
CADMATIC SOFTWARE SOLUTIONS

CADMATIC 2021T3R6 Release Notes

CADMATIC software has three main releases annually. The release name identifies the publishing
year, tertial (T1-T3), and possible patch update designation (R2 or higher). These release notes
describe new features, improvements, and bug fixes made in software version 2021T3 and its
patch updates.
l CADMATIC Plant/Outfitting on page 5
l CADMATIC Information Management on page 23
l CADMATIC Web API on page 32
l Installation Notes on page 34
2021T3R6 is a cumulative release that includes all previously released 2021T3 functionality and
patches issues that have been identified in the software after its original release. Changes made
specifically in the 2021T3R6 patch update are listed in the following:
Plant/Outfitting, P&ID
l Bug Fixes in 2021T3R6 on page 22

Starting from 2021T3, the CADMATIC installer installs Microsoft .NET Framework 4.7.2.
Do not upgrade to 2021T3 if you are using both Sister Project Management and Cable Router in
the same project. This is because the cable tool does not yet allow the cables and the cable
routing network objects of the target project to be unlinked from the source project, and as long
as these remain linked, any cable routing actions and fill rate calculations that are performed in
the target project are based on the cable ways, penetrations, and head and tail objects of the
source project. In a forthcoming update version, using the Recreate tool of the cable router in the
target project automatically unlinks all the cables and the cable routing network objects from the
source project and adjusts the cabling based on the target project.

Release Notes for CADMATIC Plant/Outfitting and IM 4

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

1. CADMATIC Plant/Outfitting
1.1. New Features in 2021T3
This software release contains the following new features.

Category Description
3D Interoperability Model > MDL Files > Import MDL from Third Party assigns the
imported objects to an aggregate group that is named after the import
file and uses the "Default" System.
Cables The new Recreate tool allows the user to generate the network of
segments and nodes that the cable router uses to find possible routes
for the cables, and a new network can be created whenever there are
significant changes in the cable ways of the 3D model. Also, the
segments and the nodes are now separate COS objects (“Cable
Network Part”), which allows the program to distribute the latest
checked-in network to all those user areas that are configured to load
cables.
Opening the Cable Manager dialog when there is no cable routing
network—or when the existing cable routing network has been created
in a previous software version—prompts the user to build a new
network. After this, changes in the cable ways are no longer
automatically applied to the cable routing network, but the user is
allowed to decide when is a good time to update the network, and
there are new tools that help the user to make this decision.
In the Recreate Cable Routing Network dialog, the user can select
whether the tool should try to reroute those cables whose main nodes
cannot be found in the new network, so that as few routes as possible
would get broken when the network changes.

Release Notes for CADMATIC Plant/Outfitting and IM 5

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description

Note: If using model area access rules, the related model queries must
be configured to allow the "Cable Network Part" object type or
the user won't be able to save the generated network.
Component A new interface for editing the cross-section boundary of plates
Manager, Plant created as Structural Components and adding holes to the plate.
Modeller
l Multi-select points to move or delete them as a group.
l Click and drag points and line segments, either freely or
orthogonally.
l Undo and redo editing actions.
l Cursor's U and V values are displayed on the screen.
l Improved visualization of what is currently selected.

Release Notes for CADMATIC Plant/Outfitting and IM 6

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
l Improved plane visualization in perspective views or when the
user rotates the view.

Documents In 2021T2 the drafting tools were moved to a modern ribbon interface,
and now in 2021T3 also the document editing functions have been
moved from the context menu to the ribbon of the active document.
l File menu contains the commands for saving, publishing and
exporting the document.

Release Notes for CADMATIC Plant/Outfitting and IM 7

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description

l Home tab contains controls for managing the document, the

pages, and the views. On this tab you can, for example, manage
drawing views and assign them to pages, use automatic labeling,
manage the Bill of Materials, and adjust the visualization of
drawing objects. As a new feature, Preview Lineweights opens a
window for showing the active document page so that each
different lineweight in the drawing sheet and in the page and
view annotations is drawn in a different color.

l Drafting tab now allows selecting whether to annotate the page

or a view and which property set to use for the annotations.

l Import tab contains import and export tools that used to be on

the Drafting tab and allows running scripts that use drafting-
related script externs.

Release Notes for CADMATIC Plant/Outfitting and IM 8

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description

l Tools tab contains special tools, for example, for adding various
markings to drawing views and allows running Plant Modeller
scripts.

Documents CADMATIC Desktop > Object > Tools > Multi-Project Maintenance

allows Plant Modeller documents created in software versions older
than 2021T2 to be converted to the new document format. Using this
tool, documents can be converted in multiple projects at the same
time.

Documents The navigation commands that lock to a 3D line are now better able to

Release Notes for CADMATIC Plant/Outfitting and IM 9

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
digitize the intended 2D point.
Integration with New COS attribute "Requires electricity (.IJ)" allows the users of
Electrical CADMATIC Electrical to more easily select the electrical devices when
importing objects from COS. The attribute can be imported from XML
to object type "External Data Management" or "Externally Provided
P&I Data" or via Web API.
Integration with New instrument-related COS attributes have been added to the
P&ID "Externally Provided P&I Data" object type: Superscript (.az), Subscript
(.J0), Instrument measure (.J1), Instrument modifier (.J2), Instrument
function (.J3), and Instrument location (.J4). All of them hold free-form
string values.
Plant Modeller On the Home tab, the Show group has a new command Visualization
Control > Erase All Objects from Views and Erase Set from Views has
been renamed as Erase Selected Objects from Views.
Plant Modeller The context menu of the Model Tree pane has a new command Fit
filter box that sets the filter box of the active shaded view so that it
contains the current tree selection.
Scripting The Script Project Manager tool (%PMS_
HOME%\pm\macro\PmMgeScriptProject.mac) allows a script
developer to easily compile all the files of a modular script
development project and then run the main script. For more
information, see Script Programming > Script Project Manager in the
online help.
Scripting New script extern PD_NEW_DIAGRAM creates a new diagram
document object to COS.
New script extern PD_CREATE_DOCUMENT_PUBLICATION script extern
creates a publication from a given diagram document.

1.2. Improvements in 2021T3

This software release contains the following improvements to existing functionality.

Category Description
P&ID The File menu is now more clearly organized and some commands
have been renamed (Save -> Save Locally, Update to COS -> Save to

Release Notes for CADMATIC Plant/Outfitting and IM 10

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
COS Database).
P&ID In the Manage External Object Data tool, if the user tries to link or
insert an EDM object using a position ID that is already used in some
other diagram, the linking is prevented and the application shows
which diagrams already contain this object.
Administration The maximum number of characters in a text box on a drawing sheet
increased to 128 characters.
3D Interoperability Improved the handling of out-of-7-bit-ASCII code characters in third-
party MDL import.
3D Interoperability IFC import now supports IFC-ZIP and newer IFC schemas such as IFC4.
3D Interoperability The IFC Export Settings dialog allows selecting the IFC schema to use in
the export and which primitives to export as solids.
3D Interoperability When inserting equipment or standard components, the column
chooser of the dialog for selecting System and position ID allows the
user to select attributes from the following categories:
l Integration Data
l Diagram Integration Attributes (NEW)
l EDM Integration Attributes
l Electrical Integration Attributes (NEW)

Electrical Integration Attributes have also been added to the column

chooser of the Manage Integration Objects dialog.
3D Interoperability When defining a selection test for a model query, the target of the test
can be a user-defined or hard-coded attribute from the category "EDM
Integration Attributes", also in model queries used by Layer Styles, Line
Attribute Styles, and Surface Shading Styles. The hard-coded attributes
are "External ID" (.as), "Position ID" (.at), and "Requires electricity" (.IJ).
Beams Beams have the following improvements:
l When inserting a beam, the shape of the beam is shown already
during the insertion.
l When inserting a beam or changing the beam part, the Pick tool
copies instance parameters from the picked beam to the target
beam.

Release Notes for CADMATIC Plant/Outfitting and IM 11

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
l When inserting a beam or rotating an existing beam, Select
refpoint for rotate (B) allows the user to select a reference point
and then use the on-screen tool to rotate the beam around that
point.
l When changing a beam part, the user is prompted to select the
reference point that shall not move when the part changes to
another.
Cables Cables have new tags for checking who routed or approved a specific
cable and when:
l Cable routed by (.GJ)
l Cable routed time (.GF)
l Cable approved by (.GI)
l Cable approved time (.GH)
Cables Improved the performance of cable queries.
Cables The Create button for creating a cable drawing was unnecessary and
has now been removed. Cabling documents can be created, like other
Plant Modeller documents, from Documents > Drawings.
Cables The Publish button for publishing the cable routing network and cable
trays as an eBrowser model was unnecessary and has now been
removed. Normal eBrowser publishing can be used to export cable-
related information to an eBrowser model.
Cables If the user modifies the Additional head and tail length and Additional
route length values in cable router settings, the new values are applied
to all existing cables whenever length information is being requested
from the program. Previously, modifying the values would only affect
new cables that were routed after the change.
Component In Component Manager, Component Modeller > Mirror now works
Manager, Plant with all primitive types.
Modeller In Plant Modeller, Home > Copy > Copy and Mirror is able to properly
mirror structural components and equipment (instead of just creating a
rotated copy) by creating a new GDL and mirroring its geometry in the
model.
Documents Regenerate View and Remove Hidden Lines can be performed in the

Release Notes for CADMATIC Plant/Outfitting and IM 12

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
Automatic Labeling dialog.
Documents The Create New Drawing dialog has a more clearly organized layout
and there is a preview of the drawing sheet.
Documents The Export Attributes dialog allows entries in the data tables of a
drawing sheet to be exported as DWG attributes.
Documents Pasting drafting objects that use linetypes, dimensions styles, or text
styles that are not available in the target project prompts the user
whether to cancel the pasting. Choosing to continue applies active
styles of the target project to the pasted content.
Ducting Rectangular duct flanges can now be constructed so that the steels that
make the flange are butt welded to the duct.
Ducting Y- and Z-offset parameters can now have negative range values in duct
part design rules.
Installation The software can now be installed, upgraded or uninstalled in silent
mode by using the installation parameter SILENT=1 to suppress all user
prompts. Using this option assumes that there are no applications
running in the installation directory when upgrading or uninstalling.
Installation The CADMATIC installer can be used to install Microsoft .NET
Framework version 4.7.2.
Integration with Instruments that are not part of a pipeline are now published from
P&ID P&ID to COS as EPD objects. However, instruments without pipelines
are still not visible in Plant Modeller.
Piping Specification check now checks if a bent pipe's part has changed in
specifications.
Piping Piping parts now support instance parameters. In pipe routing, adding
a component that has instance parameters prompts the user to define
the parameter values.
Piping When starting to route a pipe, if there is only pipeline to choose from
then that pipeline is automatically selected and the user just needs to
accept the selection.
Piping Isometrics & PCF export now contains also Valve Position Id, Instrument Position Id
Spools and Support Position Id values.
Plant Modeller The Find Objects dialog is now able to show data columns from the

Release Notes for CADMATIC Plant/Outfitting and IM 13

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
catalog.
Plant Modeller File > Options > User Settings > User Interface > Input has a new
option Direct cursor mode that can be enabled to set the CADMATIC
cursor to follow the Windows cursor. This setting is intended for
situations where using the software via remote desktop or on virtual
workstations is problematic and there is no better, virtualization
platform specific method for improving the cursor's behavior.
Note that when using this cursor mode, it is possible to use the arrow
keys for moving even if the cursor position is locked. Also, moving a
single object sets the base point in the origin of the object and moving
multiple objects uses the origin of the first selected object.
Plant Modeller Improvements to the Model Tree pane:
l The context-menu command Get Object's Group (B) now opens
a dialog where the user can select a group the object belongs to
and then either locate the group in the model tree or open the
Query Object Data dialog for showing information about the
group.
l When selecting a set of objects, the context-menu command
Include Model Tree Selection adds the items that are currently
selected in the model tree to the set.
l Model tree searches can be limited by typing a prefix that
consists of a predefined letter followed by two colons. For
example, searching for "g::MyGroup" would only find groups that
match the string "MyGroup", and all other types of objects that
match "MyGroup" would be excluded from search results.
l The Groups sub-menu of the context menu now contains
commands for checking in/out the selected groups but not their
members.
Plant Modeller The context-menu commands Select Groups, Include Members of a
Group, Include Members of Groups, Include a Group Recursively, and
Include Groups Recursively have been replaced with a single
command, Select Groups or Members.
Plant Modeller The Select Component dialog has a more clearly organized layout in
general, the part size options are listed as a table, there is a standard

Release Notes for CADMATIC Plant/Outfitting and IM 14

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
column chooser for displaying attributes, and new search field filters
the part list as soon as the user starts typing the search string.
Plant Modeller The tag selection dialog now supports multi-selection and new search
field filters the tag list as soon as the user starts typing the search
string.
Plant Modeller The Editing Query dialog has a Select All option for object types and a
more clearly organized layout in general.
Plant Modeller Tools > EloTools > Piping > Change Parts in a Set now supports
specifications 4–5. Also some dialog resizing issues were fixed in the
tool.
Scripting New script extern PM_CRN_GET_FILLRATE_AT_SEGMENT returns the
fill rate percentage of a cable routing network segment.
Usability Certain dialogs are now more compatible with Windows scaling
options; resizing such dialogs can no longer cause elements to overlap
with each other or get hidden.
Usability Date and time values are now shown in the ISO 8601 format: 2021-10-
28 14:15.
Usability Context menus now allow commands to be organized under sub-
headings.
Usability Drop-down menus that contain just one item now indicate that it is the
only choice.

1.3. Improvements in 2021T3R4

This software release contains the following improvements to existing functionality.

Category Description
Administration In 2021T3, the Home > Copy > Copy and Mirror commands were
changed so that instead of just creating a rotated copy of the model
object, they would create a new, mirrored copy of the component
model and automatically save it in the database. This could result in
many new, sometimes unintentionally created library objects.
In 2021T3R4, the Home > Copy > Copy and Mirror commands check
whether the component model has the attribute "Allow mirror copies

Release Notes for CADMATIC Plant/Outfitting and IM 15

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
to database" set to "Yes", and if it does, the user is prompted whether
to keep the existing component model as is and create a new, mirrored
component model in the database (which can be either the library or
the project database). If the attribute is missing or is set to "No", the
copied object is rotated in the model, as was done before 2021T3.
Documents Improved the speed of regenerating drawings.
Plant Modeller The minimum allowed angle for bends and flexible elbows is now 1°
instead of 3°.

1.4. Improvements in 2021T3R5

This software release contains the following improvements to existing functionality.

Category Description
Documents The Drawing Views dialog has a new command Create > Copy selected
Views that copies the selected drawing views so that also the
annotations are included in the new copies.
Documents Improved the speed of opening drawings that have a lot of object
references in their Bill of Materials.

1.5. Bug Fixes in 2021T3

This software release contains the following bug fixes.

Category Description
P&ID Dragging a pipe run to connect it to a point on a symbol where there is
no node was no longer working. Now the user is prompted to select
whether to create a node and connect the pipe run to the symbol or
not.
P&ID Pipelines were shown to have attributes they did not have, if the user
had selected SQL data to display for the pipelines.
P&ID In Drawing export configuration, if a sub-table was defined in the
Attributes and Hyperlinks section, the attributes were not exported at
all. Because the sub-table is not required, it was removed from the
configuration settings.

Release Notes for CADMATIC Plant/Outfitting and IM 16

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
P&ID Editing the Menu Item Data section of a Diagram Object Template only
updated the change to the SQL database but not to the "PD object
menu item data" attribute of the object template in question.
P&ID In some cases, moving objects with Move or Move Aligned with Grid
Off and Snap On caused the objects to end up slightly off the grid even
when the objects were originally drawn with Snap On.
P&ID Tools > Follow Up did not work properly.
P&ID After editing the data of a pipe run or instrument line, closing the
editor applied a wrong line thickness value to the line. However, this
change was only temporary since other operations like Save, Update to
COS, Export, and Print would return the thickness back to normal.
3D Interoperability PCF export files would in some cases miss the continuing part
information.
3D Interoperability PCF import and export were incorrectly connecting the auxiliary point
of blind flanges to the flange end.
3D Interoperability In the 3D-Import Options dialog, the user could circumvent System
selection restrictions by manually entering a System ID.
3D Interoperability 3DDX export license was not released if the export failed due to a non-
existing export directory.
Cables If the cable route had a cut in the cable tray, perpendicular segments
to other trays were not correctly created.
Cables Manual cable routing allowed the user to create a double air jump at
the start or end of a cable. This is no longer allowed.
Cables Auto-routing multiple cables at the same time allowed the fill rate of
segments and penetrations to exceed 100%.
Component When inserting a plate using a template curve, the commands
Manager, Plant Measure, Probe and Measured Value could no longer be found from
Modeller the context menu of the parameter value fields. Now the commands
are available again.
Documents Changing the part numbering format of pipe spools from numbers to
letters (A,B,C…) did not change the numbering in the bill of materials.
Documents Drawing was reported as having been edited even if no changes had
been done.

Release Notes for CADMATIC Plant/Outfitting and IM 17

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
Documents In Plant Modeller versions 21.2.0–21.2.3, copying work views into
documents produces faulty view rebuild scripts. When such document
is regenerated or imported from CX, the drawing view files go missing
and the user cannot work with the views.
In Plant Modeller versions 21.2.4 and above, copying of work views
functions correctly and problematic documents can be fixed with a
script that is available in the delivery environment.
If opening a previously created document displays an error message
such as "Failed to open file 'drawing.bin\b13ff171-19e7-4f54-96f8-
dfff54456abc/Back.cr'
Errno 2 : No such file or directory", select Tools > Script from the
document editor ribbon, browse to $PMS_
RUNDIR\pm\macro\Diagnostics, and run the script
FixMissingDrawingViewFiles.bs. This fixes the open document by
correcting the rebuild script, rebuilding the views and saving locally,
and after this the user can continue to work with the document
normally.
Documents When drawing text uses a font that does not have some of the used
characters, the automatic search for a suitable substitute font did not
always produce good results.
Duct Spools Attribute values were not visible in the fields of the drawing sheet.
Duct Spools Adding objects to duct spools using 3D pick left out flanges from spool
drawings unless the option that allows non-duct part types was
selected in File > Options > Shared Settings > Ducting > Duct Spool.
Now 3D pick selects objects regardless of this setting.
Integration with The integration with CADMATIC Electrical didn't recognize the situation
Electrical where the cable part in the library or the project database was not
owned by the site that the electrical integration was connected to. In
Electrical, the user now gets a better error notification if the mapping
of cable material fails due to an ownership problem.
Integration with Tools > Manage > Compare Objects did not compare the System of
Electrical objects of type "Electrical Device".
Integration with Tools > Manage > Compare Objects compared instance parameters of
Electrical Electrical Devices even when the Template IDs differed. Now they are

Release Notes for CADMATIC Plant/Outfitting and IM 18

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
no longer compared.
Integration with Hull Instructing the Hull Agent to remove the same plate twice caused the
application to crash.
Piping Bolt hole orientation angle was shown incorrectly.
Piping When copying objects, creating a new pipeline for the new objects did
not assign the objects to that pipeline.
Piping "Penetration Position Id" (.lh) attribute could not be assigned to piping
parts although it could be assigned to pipe parts in 2019T2 and earlier.
Now also piping parts support this attribute.
Piping Isometric & Bending machine simulation caused the pipe to rotate into wrong
Spools direction in some rare occasions.
Plant Modeller When calculating total mass (TMA), the mass of insulation was not
calculated properly if the insulation specification did not have extra
materials defined.
Plant Modeller External Data Management (EDM) objects created with XML import
were not relinquished to master site from a replica.
Plant Modeller Objects with broken geometry would prevent the user from opening
any Plant Modeller areas. Now, if such objects exist, Plant Modeller
automatically opens a tool that allows the user to find the broken
objects from the model area.
Plant Modeller Plant Modeller area could not be started if the area had been created
in an earlier software version and the requirement to use model area
access rules had been added to the project later.
Plant Modeller Using the Shift key in object selection did not work when Auto-Select
Others in Spool was enabled and Highlight Object Under Cursor was
disabled.
Plant Modeller Project creation failed if CX file contained objects with null OID
references.
Plant Modeller 3D objects turned opaque after modifying instance parameters.
Plant Modeller Active point clouds were not activated when restarting Plant Modeller.
Plant Modeller Home > Visualization Control > Set System Colors to Open Views did
not work; the command has now been removed.

Release Notes for CADMATIC Plant/Outfitting and IM 19

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
Scripting PM_GET_OBJDATA did not return the part numbers of objects in
drawings if the drawing was opened for browsing.

1.6. Bug Fixes in 2021T3R4

This software release contains the following bug fixes.

Category Description
P&ID Selecting a component model for an instrument with the Spec button
would crash the application.
P&ID Opening a checked-in diagram for editing did not call the
PdOpenDiagram function (if defined in the "set_defaults" script).
3D Interoperability Some object types would cause 3D export to crash the application.
Administration Using the Multi-Project Maintenance tool to convert a large number of
documents to the new format could cause the application to run out of
memory and crash. Now the conversion is automatically performed in
smaller batches.
Beams Increased the maximum height of Unequal I-beam and Double Web I-
beam from 1 meter to 10 meters.
Cable Trays Quantity tag and instance parameters were missing from cable tray
parts.
Cable Trays Mirroring a cable way space would create erroneous objects.
Component Modeller Component Modeller would crash if the user tried to insert or modify a
nozzle with a wireframe view open.
Documents Drafting objects that had been drawn in white color were not visible in
PDFs exported from the new drafting platform. Now PDF export
changes white to black, as before.
Documents Selecting the Add a point context-menu command would crash the
application.
Documents In the CADMATIC example project, drawing views were erroneously
displaying some objects as transparent.
Documents Export color mappings were not applied to textbox fields defined as
attributes, which could cause sheet texts to be exported in wrong
color. Now also sheet attributes are exported in user-defined colors.

Release Notes for CADMATIC Plant/Outfitting and IM 20

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
Integration with Instruments created before 2021T3 were not correctly shown in Plant
P&ID Modeller.
Japanese Yards Link The script extern PM_ACTIVATE_PAGE_IN_DRW would fail if the
drawing was not visualized in a window.
Plant Modeller In specific situations the application would crash at start-up. Now the
crash is prevented by not allowing the application to initiate reading
from COS at the same time as it is receiving a notify message from COS.
Plant Modeller Using the Home > Copy > Copy and Mirror commands in a project that
uses a local coordinate system could fail due to the transformation
violating the limits of the project space.
Plant Modeller The user could not interrupt the rendering of a large scene or point
cloud by moving the cursor or zooming.
Scripting DW_GETOBJID would sometimes return an invalid handle.

1.7. Bug Fixes in 2021T3R5

This software release contains the following bug fixes.

Category Description
Component Modeller The Face-sets in a box selection method did not always select the same
set of objects.
Component Modeller Inserting a curve could cause Component Modeller to crash.
Documents Copying a drawing view from another document could set a wrong
scale to some of the annotation objects.
Documents Commas, semicolons, and equality signs are now properly supported in
names of drawing views. Previously, views with such names would be
lost when a document created before 2021T2 was converted to the
new document format.
Documents When converting documents to the new document format, unused
views were discarded. Now they remain as unused views also after the
conversion.
Documents The Multi-Project Maintenance tool could crash when attempting to
access a project that was not updated to the current version. The tool
now handles this situation correctly and reports an error to the user.

Release Notes for CADMATIC Plant/Outfitting and IM 21

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
Documents Importing more than 200 2D files into a document would cause Plant
Modeller to crash.
Documents Linear measure factor given to dimensions was lost when exporting a
document as DWG or DXF.
Plant Modeller Loading corrupted, geometry-less Hull objects caused Plant Modeller to
crash.
Plant Modeller Loading or showing so-called phantom objects could cause Plant
Modeller to crash.

1.8. Bug Fixes in 2021T3R6

This software release contains the following bug fixes.

Category Description
Plant Modeller With specific data, opening the Plant Modeller would cause it to
immediately crash.

Release Notes for CADMATIC Plant/Outfitting and IM 22

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

2. CADMATIC Information Management
2.1. CADMATIC eShare
2.1.1. New Features in 2021T3
This software release contains the following new features.

Category Description
Administration Project administrator can now import DGN files directly to eShare in
Project Administration > Model.
Administration Project administrator can select to exclude model attributes from the
published 3D model in Project Administration > Model > Attribute
Settings.
Administration SQL queries in Object Attributes Data Source for Database Adapter can
be defined in a simpler way using a Query Builder, when the database
type is Microsoft SQL Server.
Administration eShare server and individual projects can be backed up and restored
using eShare Backup Restore command-line tool.
Administration Excel adapter has a new data source, Excel Historical Data Source,
which provides history data for objects or groups in the form of a
graph in the properties pane for the object or group.
Administration Database adapter has a new data source, Historical Data Source, which
provides history data in the form of a graph in the properties pane.
Administration Location coordinates of an object can now be generated as attributes
to the object in 3D model. This includes bounding box center,
minimum, and maximum coordinates. Project administrator can select
to include them in Project Administration > Model > Model
Publishing.
Administration Document Data Source for Database Adapter now supports retrieving
documents directly from the database.
Administration The connection string for a database adapter can be defined in a
simpler way when the selected database type is Microsoft SQL Server.
Administration Improved import of IFC files, including import settings on

Release Notes for CADMATIC Plant/Outfitting and IM 23

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
transformations, wireframes, parent attributes, empty valued
attributes, and ifcProducts, as well as support for IFCzip files. See
Changes in IFC Importer on page 45 in Installation Notes.
Administration Improved import of DWF, DWG, and DXF files, including settings on
transformations, freeze and off layers, optimization, and geometry
reduction.
The models can also be scaled during import.
Administration Project administrator can now create new attributes based on the
existence of other attributes in the model in Project Administration >
Model > Attribute Settings.
3D Interoperability eShare user can download the currently published model as EBMX file.
The download link can be disabled in application settings.
3D Model Saved scene now includes the visibility and transparency of objects as
they were when the scene was saved, if objects have identifying
GUIDs.
Settings > Other Options has a new Scene Saving Settings dialog for
selecting if transparent objects, opaque objects, or no transparency
information is saved to scenes, as well as selecting if visible objects,
hidden objects, or no visibility information is saved to scenes.

Map eShare user can now add a Smart Point from the Map.
Point Clouds Added Point Cloud Converter, a command-line tool, which can convert
large point cloud files (CPC, CPD, CPE, CPX, E57, PTX) to small .cpx files.

Release Notes for CADMATIC Plant/Outfitting and IM 24

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
Search not equal operation was added to Model Object Search, and Smart
Point and Markup Search.
Usability Added user profile page, where user name can be viewed and edited,
and user's groups and latest activity on markups are shown for users in
the same project. System administrator controls which details are
visible and permits modifications by each user.

2.1.2. Improvements in 2021T3

This software release contains the following improvements to existing functionality.

Category Description
Administration Links injected to managed documents can now be indexed.
Administration Administrator can now set a target frame for hyperlinks in Object
Attribute Data Source for Database Adapter.
Administration Project or system administrator can now set the category for the status
tracking to be displayed in the properties pane.
Administration Document type configuration can include both target data source(s)
and a metadata pattern to target specific documents.
Administration Attribute script transformation supports iteration of attributes.
Administration Added support for list style JSON responses in Object Attributes Data
Source for REST API Adapter.
Administration Project administrator is now able to share a saved search with all
project users or specific user groups.
Documents Added support for line breaks in document metadata extraction
patterns.
3D Model Only left-click on top of a scanner location marker opens bubble view.
3D Model In the context menu, Hide Others has been replaced by Show Selected
and Hide Unselected and Hide Unselected.
Show Selected and Hide Unselected shows the selected objects and
hides all unselected objects.
Hide Unselected hides all unselected objects.
3D Model Navigation menu in the main toolbar now includes Bottom view. The

Release Notes for CADMATIC Plant/Outfitting and IM 25

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
shortcut keys for the views have been updated.
3D Model Added two new parameters to eShare Model View URL API: searchFor
and searchScope.
searchFor takes a string, which is matched directly to the entities of the
given scope.
searchScope takes a string, which lists the types of entities that
searchFor goes through.
3D Model The highlight on the selected object or group is now more distinct in
the model tree.
Search Smart Point and Markup search is now more accurate, suggesting
automatically only relevant values based on the selected type of Smart
Point or Markup.
Search Excel export of search results can be configured to export only objects
with differences in selected two attributes, which can be from the 3D
model or an external source.
Usability The eShare App browser engine was changed for better performance.
Some settings in Internet Options may not affect eShare App the same
way as in previous versions. The size of the eShare App installer
package has increased significantly due to required dependencies. See
Changes in eShare App Installer on page 46 in Installation Notes.
Usability Days of the month in indexing configuration for managed documents
using Days of month mode are now listed in ascending order.
Usability Improved the performance of advanced search of Markups and Smart
Points.

2.1.3. Improvements in 2021T3R2

This software release contains the following improvements to existing functionality.

Category Description
Administration Status tracking types can be defined to be used only for grouping by
enabling Used for Grouping in Project Administration > Status
Tracking and Object Grouping > Status Tracking Details.
Search If a search returns a large number of markups, all results are presented,

Release Notes for CADMATIC Plant/Outfitting and IM 26

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
but they are divided into multiple views with a maximum of 100 results
shown on each view.

2.1.4. Bug Fixes in 2021T3

This software release contains the following bug fixes.

Category Description
Administration Values set by script transformation to attributes defined in the model
were not added to the attributes if they were not originally present in
the object.
Administration New status tracking type with empty transition matrix did not have all
transitions allowed.
Administration In some scenarios the number of categories in Attribute Categorization
was misleading when a categorization was removed.
Administration Disabled adapters were visible in the General and Dashboard view,
after importing disabled adapters containing enabled document data
sources.
Administration Data source configuration appeared to be saved after clicking Cancel in
some cases.
Administration Importing empty sub-model division rules sometimes caused an error.
Administration Navigating to Sub-Models view gave an error after importing sub-
model division rules.
3D Model Revealed hidden attributes were hidden again when the properties
pane was refreshed by eShare.
3D Model Linked Smart Points were shown twice in the properties pane.
3D Model Adding Smart Points and Markups to objects was not possible without
an attribute to be linked to.
3D Model Duplicate cable data caused issues when publishing the 3D model.
3D Model Large models with cables caused timeouts during model publishing.
3D Model Point clouds in eShare status tracking or categorization hierarchies
occasionally caused errors.
Documents Link coloring configurations were not correctly imported when

Release Notes for CADMATIC Plant/Outfitting and IM 27

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
importing the document type configuration.
Documents Link coloring configurations were sometimes visible in Document
Viewer, even if link coloring was disabled.
Documents Indexing skipped documents after Document Processing Rules in
Document Type Settings were changed and documents re-indexed.
Documents Document legend was not visible in some documents, which caused
the link locations to be off target in Document Viewer.
Documents The appearance of document legend was wrong in rotated documents.
Map Using the Refresh button in Map view caused an error in some
situations.
Markups The statuses of markups imported from BCF files did not update
correctly.
Search Selecting Examine all objects in search results sometimes caused an
error.
Search Markup search results were not restricted to 200 results the same way
as other search results.

2.1.5. Bug Fixes in 2021T3R2

This software release contains the following bug fixes.

Category Description
Administration Database adapter changed the connection string incorrectly in the
adapter configuration in some cases.
Documents Link placement of pdf documents in Document Viewer was incorrect, if
the pdf was cropped in a certain way.
Usability Some messages were not visible in Model view when using Internet
Explorer.

Release Notes for CADMATIC Plant/Outfitting and IM 28

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

2.2. CADMATIC eGo

2.2.1. Improvements in 2021T3
This software release contains the following improvements to existing functionality.

Category Description
3D Model Places now include Bottom view as a stored scene for all models.

2.2.2. Bug Fixes in 2021T3

This software release contains the following bug fixes.

Category Description
Usability Dragging the Orbit Point droplet to the trash can or using Delete All did
not delete the droplet.

2.2.3. Bug Fixes in 2021T3R2

This software release contains the following bug fixes.

Category Description
3D Model Links to managed documents where not shown for groups in some
cases.

2.3. CADMATIC eBrowser

2.3.1. New Features in 2021T3
This software release contains the following new features.

Category Description
3D Interoperability eBrowser supports the import of DGN files.
3D Interoperability Improved import of DWF, DWG, and DXF files, including settings on
transformations, freeze and off layers, optimization, and geometry
reduction.

Release Notes for CADMATIC Plant/Outfitting and IM 29

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
The models can be also be scaled during import.
3D Interoperability Improved import of IFC files, including import settings on
transformations, wireframes, parent attributes, empty valued
attributes, and ifcProducts. Import of ifcZIP files is also supported.
3D Interoperability File import now includes the option to reduce the imported geometry
size by reducing the triangle mesh accuracy.
The file formats include DGN, DWF, DWG, DXF, IFC, IFCzip, and NWD.
3D Model Saved scene now includes the visibility and transparency of objects as
they were when the scene was saved, if objects have identifying GUIDs.
Settings > Other Options now has a new Scene Saving Settings dialog
for selecting if transparent objects, opaque objects, or no transparency
information is saved to scenes, as well as selecting if visible objects,
hidden objects, or no visibility information is saved to scenes.

2.3.2. Improvements in 2021T3

This software release contains the following improvements to existing functionality.

Category Description
3D Interoperability Navisworks importer can utilize geometry templating for better
performance (faster rendering and less memory consumption) with
large models.

Release Notes for CADMATIC Plant/Outfitting and IM 30

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Category Description
3D Model Only left-click on top of a scanner location marker opens bubble view.
3D Model Navigation menu in the main toolbar now includes Bottomview. The
shortcut keys for the views have been updated.
3D Model The highlight on the selected object or group is now more distinct in
the model tree.

2.3.3. Bug Fixes in 2021T3

This software release contains the following bug fixes.

Category Description
3D Interoperability Publishing multiple expiring EBM models in batch mode created invalid
models.
Usability Clicking on Buy button without subscription selection caused eBrowser
to freeze.
User interface Status information texts on loading the 3D model sometimes
overlapped.

Release Notes for CADMATIC Plant/Outfitting and IM 31

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

3. CADMATIC Web API

CADMATIC Web API allows connecting CADMATIC products and third-party product lifecycle
management systems, and transferring project data through an integration software. CADMATIC
Web API supports reading, creating and updating part attribute data, objects with a position ID
and attributes, and document metadata, as well as fetching document publication files.

3.1. New Features in 2021T3

This software release contains the following new features.

Category Description
Endpoints Added functionality for reading piping, duct, and cable tray
specifications from the Web API, along with the part sizes that are used
in the specifications.

3.2. Improvements in 2021T3

This software release contains the following improvements to existing functionality.

Category Description
Endpoints Web API now supports fetching published Electrical and Hull
documents.
Endpoints Parts endpoints in Web API now support reading and updating objects
from the library database.
Installation Web API installer now allows the user to choose a custom directory for
the Web API files during installation.
Management Tools Optimized the memory usage of the Web API management tool and
improved the performance of filtering and sorting the log of events.
Upgrade Web API installer now allows the user to choose a workstation profile
when upgrading the service.

Release Notes for CADMATIC Plant/Outfitting and IM 32

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

3.3. Bug Fixes in 2021T3

This software release contains the following bug fixes.

Category Description
Installation Web API did not validate the service name before installing and caused
an error in finding the configuration file.
Management Tools Reading the log at the same time as the Web API was writing into the
log could cause the CADMATIC Web API Management Tools dialog to
crash.
Usability Plant Modeller areas created by the Web API were not removed when
a project was removed from the Web API, or the Web API was
uninstalled. This caused unused areas to remain in COS.
Usability Copying the secret key in some remote desktop clients caused the Web
API to shut down.

3.4. Bug Fixes in 2021T3R2

This software release contains the following bug fixes.

Category Description
Endpoints The /api/{project}/epds/create/ endpoints did not add the given
specification OID to the created EPD object.

3.5. Bug Fixes in 2021T3R4

This software release contains the following bug fixes.

Category Description
Endpoints The /api/{project}/exports/add endpoint failed if the Directory option
did not specify the export folder and the default folder
C:\ProgramData\Cadmatic\WebApi\<service name>\exports did not
exist. Now the endpoint creates the default export folder, if needed.

Release Notes for CADMATIC Plant/Outfitting and IM 33

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

4. Installation Notes
Installation packages for all CADMATIC products can be downloaded from the CADMATIC
Customer Support Portal at support.cadmatic.com. Consider the following compatibility and
upgrade notes before installing any products included in this release. For detailed installation
information, see the installation guide of individual products.

4.1. Version Compatibility

Consider the following compatibility notes before installing this release. When using integration
features between two CADMATIC products, make sure the product versions are compatible with
each other.
l CADMATIC License Server must be upgraded to 2021T3. The license file from 2021T1 is
compatible with the license server of 2021T3 releases.
CADMATIC License Server 2021T3 is compatible with Plant/Outfitting 5.0 and newer.
l CADMATIC Plant/Outfitting 2021T3 is compatible with CADMATIC Electrical 2021T3
(19.0.3).
Do not use older Electrical versions together with Plant/Outfitting 2021T3.
l CADMATIC Outfitting 2021T3 is compatible with CADMATIC Hull 2021T3.
Do not use older Hull versions together with Outfitting 2021T3.
l CADMATIC Plant/Outfitting 2021T3 is compatible with CADMATIC eShare 2021T3.
Do not use older eShare versions together with Plant/Outfitting 2021T3.
l CADMATIC eShare 2021T3 is compatible with CADMATIC eGo 2021T3.
Do not use older eGo versions together with eShare 2021T3.
l CADMATIC eShare 2021T3 is compatible with CADMATIC eShare for HoloLens.
l CADMATIC eBrowser is compatible with ebm/ebmx files published with Plant Modeller
from the same or older release.
Older eBrowser versions may not be able to open ebm/ebmx files published with the
newest Plant Modeller.
l ebm files published with Plant Modeller 2021T3 are not compatible with eShare 2021T3 if
the ebm file has an expiration date.

Release Notes for CADMATIC Plant/Outfitting and IM 34

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

4.2. CADMATIC Plant/Outfitting Upgrade Notes

Follow these instructions to upgrade CADMATIC Plant/Outfitting to 2021T3R6.
l Preparations for Upgrading from Version 6.0.X on page 35
l Preparations for Upgrading from Version 6.1.X or Newer on page 36
l Preparations for Upgrading from Version Older than 2019T3 on page 36
l Upgrading the License Server on page 42
l Upgrading the COS Server on page 42
l Upgrading the Applications on page 43
l Converting Projects on page 43
l User Areas After the Upgrade on page 44
l Converting Documents on page 44

4.2.1. Preparations for Upgrading from Version 6.0.X

Perform these tasks before upgrading from version 6.0.X to the latest release.

Note: If your current version is older than 6.0.7, you must first upgrade it to 6.0.7.
If the Diagram application is used, you must perform an intermediate upgrade to 6.1.4,
and then you can proceed as described in Preparations for Upgrading from Version 6.1.X
or Newer on page 36.

l Ask users to save and check in their data:

l All objects.
Note that even though Check-in all objects is performed, some temporary spool
attribute objects remain in the ownership of the Plant Modeller area; this is normal
and does not prevent upgrading.
l All documents: Plant Modeller drawings, isometric and spool drawings, and
diagrams.
l Perform these verifications at the master site:
l Verify that all ownerships have been received from replicas.
l Open Library and Project Databases and verify that replicas have checked in all
relevant objects. Do NOT select Force cancel check-out or Take All, because replica
sites can keep the ownership of Plant Modeller areas and replica sites.
l We recommend that you exit all Plant Modeller areas.
l Make sure that online replica servers have been set offline from Manage COS.

Release Notes for CADMATIC Plant/Outfitting and IM 35

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l Create a backup from COS, and save the backup in a secure location, so that it is available
after the upgrade if needed. If using the Diagram application, back up its SQL database.
Backups must be created at all master sites of library and project databases just before
upgrading. Additionally there should be the previous nightly backup from all replica sites.

4.2.2. Preparations for Upgrading from Version 6.1.X or Newer

Perform these tasks before upgrading from version 6.1.X or newer to the latest release.
l Perform these verifications at each replica site:
l Verify that the latest update files have been received, so that all COS servers contain
the same data.
l Verify that all configuration objects in the library and project databases are owned
by the master site.
l Create a backup from COS, and save the backup in a secure location, so that it is available
after the upgrade if needed. If using the Diagram application, back up its SQL database.
Backups must be created at all master sites of library and project databases just before
upgrading. Additionally there should be the previous nightly backup from all replica sites.

4.2.3. Preparations for Upgrading from Version Older than 2019T3

If you are upgrading from a version older than 2019T3, consider the following information before
upgrading to 2021T3R6.
l GUID-based Plant Modeller Object IDs on page 36
l Same Piping Objects in Plant Modeller and COS on page 38
l Hole Requests Have Their Own Object Type on page 42
l EBMs Require Updated Information Management Products on page 42

4.2.3.1. GUID-based Plant Modeller Object IDs

In the past, Plant Modeller objects have had object IDs that were 2–8 characters long. Object IDs
were queried with the tag "obi" in scripts and material reports. The value of "obi" was unique
only inside a single project. Project administrators of master sites needed to allocate object ID
ranges to their replica sites to guarantee the uniqueness of IDs in the whole project.
Starting from 2019T3, Plant Modeller object IDs are GUIDs (36 characters). For object
identification, there is also a packed version of the GUID: the OID (22 characters).
GUIDs and OIDs are syntactically the same as has been used for identifying COS objects since the
advent of COS. Thus, object identifier formats are now unified in Plant Modeller and COS.

Release Notes for CADMATIC Plant/Outfitting and IM 36

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

The object identification tags in 2019T3 and later:

Value length
Script #define Tag in characters Description
MMT_TAG_GUID ".mh" 36 The GUID value. The value is a valid
basename for a file.
MMT_TAG_COSOID ".pY" 22 The OID value, i.e. a packed GUID value.
Cannot be used as a basename for a file.
MMT_TAG_OBJID "obi" 36 Obsolete, but for backwards
compatibility in 2019T3 and later returns
the GUID value (i.e. is same as ".mh").
Examples of the values:

Script #define Tag Example value in 2019T3 Example value in 2019T2

MMT_TAG_ "obi" 8df462fa-e06a-496c-89b4- 8061
OBJID ceda7c425116
MMT_TAG_ ".pY" ZVHY_k1gIMo9jCxQV49H5W ZVHY_
COSOID k1gIMo9jCxQV49H5W
MMT_TAG_ ".mh" 8df462fa-e06a-496c-89b4- 8df462fa-e06a-496c-
COSOID ceda7c425116 89b4-ceda7c425116

Note: The tags ".pY" and ".mh" were implemented in a previous version, to prepare for the
change in 2019T3. This is why they existed already in 2019T2.

Effects in general:
l In all new usage, CADMATIC recommends that from now on you use either ".pY" or ".mh"
instead of "obi". You are not enforced to change the existing data which uses "obi", but be
aware of the things that are listed below.
l Administrators no more define object ID ranges for replicas. Existing replicas for which a
range has been defined in a previous version will work after the upgrade without actions by
admins. Object ID ranges will simply be ignored.
l If you have old scripts that just assign the value of "obi" into a variable and thus store the
value temporarily in the memory, the scripts will work without any modifications. This
applies to most of the scripts.
l If you have old scripts that print the "obi" value into a file or as text in some user interface
widget, the output formatting may need some action, since the value is much longer now.

Release Notes for CADMATIC Plant/Outfitting and IM 37

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l If you are interfacing CADMATIC with an external database based system, such as an ERP or
a PDM, and these store Plant Modeller "obi" values, the external system may need to be
reconfigured, since the storing field must now accept 36 characters long GUID values
instead of max. 8 characters long old "obi" values.
l Some customers have used the old 2-8 character long "obi" values as unique position ID
values and labeled them in drawings. In 2019T3 the returned GUID value is very likely too
long for that kind of purpose. Even the ".pY" tag's value might be too long. In these cases,
some changes are very likely needed.
l It is possible to import a 2019T2 CX file into current Plant Modeller version without any
special actions.
What to check:
l For most users the change will be transparent.
l If there are some labels, reports, or other output that includes the object ID, it is necessary
to check how they are visually impacted, as the new object ID is much longer than the old
object ID.
l If there is output to an external database such as ERP or PDM, it is necessary to check that
the storing database field is able to store the new longer object ID.

4.2.3.2. Same Piping Objects in Plant Modeller and COS

At runtime, Plant Modeller has modeled piping objects using the special "PIPE" object type which
is a kind of "aggregate" of real-world piping components. For example, one PIPE object could
consist of a flange, a pipe, an elbow, and a reducer. However, when storing the objects into COS,
the PIPE structure was split into separate objects, matching the real-world component division.
Starting from 2019T3, the PIPE object does not exist anymore—it has been replaced with
component-level piping objects, so that now there is 1:1 mapping between the piping objects in
Plant Modeller and those in COS. This change has various benefits:
l All routing modules now manage objects in the same manner.
l Handling of piping objects should be easier now, especially for new users.
Because of the way piping objects are internally managed, also the user interface for managing
and editing piping has to some extent changed.
Example - Define Set
When defining a set of objects, the context-menu option Auto-Select Others In Spool is
automatically on, and the application uses spool-break rules to determine which piping parts to
select into the set. You can disable the option from the context menu if you want that only the
picked piping part is selected.

Release Notes for CADMATIC Plant/Outfitting and IM 38

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

If the auto-select option is turned off, after picking one piping part you can add the others into
the set with the Add Others in Spool (Alt+S) command. Note the following:
l Auto-Select Others In Spool and Add Others in Spool select the adjacent parts that
according to spool break rules can form a single prefabricated pipe. If spool break rules do
not exist in the library database, default break rules are used.

l In addition to the main pipe, the dependent selection methods can also select branch
pipes. Therefore, the commands Scan Pipe and its Branches Recursively (K) and Scan Pipe

Release Notes for CADMATIC Plant/Outfitting and IM 39

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

Only (Shift+K) are no longer available.

l The dependent selection methods select Standard Components that do not have a Valve
Position Id:

l The dependent selection methods do not select Standard Components that have a Valve
Position Id:

Moreover, a continuous sequence of piping parts can be selected by pressing down Shift and
then clicking the first part and the last part in the sequence. Branch pipes that belong to the same
pipeline are automatically added to the set. Onto-line parts are added to the set if the context-
menu option Auto-Select Dependent is on when selecting the last part.

Release Notes for CADMATIC Plant/Outfitting and IM 40

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

What to check:
ICGDs
l ICGDs that explicitly refer to object type (obt) "3", for example "obt;3;4" should still work.
However, it might be clearer and more future-proof to use "obt;9;10" instead.
l Object type ranges should be checked to include "9" where necessary.
Queries
l Queries that explicitly look for object type (obt) "3" should still work.
l In object type selection, "Piping Part" should be selected by default where "Pipe" was
selected before. If there are more complex conditions, such as object type ranges or
negations, check that object type "9" is included where necessary.
Scripts
l Scripts that use object type (obt) "3" (MMT_OBT_PIPE) should still work.
l If script contains set definitions, check that obt "9" (MMT_OBT_PIPING_PART) is used.
Plant Modeller objects do not use obt "3" anymore.
l If there are for–loops that traverse object types, it may be necessary to take obt "9" into
account. In general, check that all scripts function properly where object type related
conditions are used.
eBrowser Model Publishing Settings
l In eBrowser Model Publish Settings configurations, obt "3" should be replaced with "9" to
ensure future functionality.

Release Notes for CADMATIC Plant/Outfitting and IM 41

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

4.2.3.3. Hole Requests Have Their Own Object Type

Starting from 2019T3, hole requests have their own object type (obt) "17". Previously, hole
requests used obt "4" (Structural Component).
What to check:
l Similarly to the pipe object change described in Same Piping Objects in Plant Modeller and
COS on page 38, resources such as scripts that handle hole requests as object type "4"
should be updated to use object type "17" instead.
l In queries that include hole requests, select the new object type "Hole Request".

4.2.3.4. EBMs Require Updated Information Management Products

Due to object IDs being longer now, as described in GUID-based Plant Modeller Object IDs on
page 36, EBM files created by Plant Modeller 2019T3 or newer cannot be used in eBrowser,
eShare or eGo version 2019T2 or older.
What to check:
l eBrowser, eShare, and eGo have been updated to 2019T3 or newer.

4.2.4. Upgrading the License Server

l Check that your license file is compatible with this release. 2021T3 requires a license file
from 2021T1, so the license file name should contain the respective version number:
<name>_2110...lcf.cry.
l Uninstall the previous license server from Control panel > Programs and Features.
If Sentinel System Driver Installer displays a version number that is older than 7.6, uninstall
also the sentinel driver.
l Start the 2021T3R6 installation program and select to install the license server. You can
install the sentinel driver at the same time, if needed; be prepared to unplug and plug in
the license sentinel key when instructed to do so.

4.2.5. Upgrading the COS Server

l Start the 2021T3R6 installation program, select Install COS, and follow the instructions of
the installation wizard.
l Upgrade COS server to version 21.3.6.
l If you are about to upgrade a 32-bit COS server to 64-bit, you are prompted that also all
replica servers must be upgraded to 64-bit. If in doubt, do not proceed with the upgrade.

Release Notes for CADMATIC Plant/Outfitting and IM 42

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l If upgrading from a much older version, give COS server enough time to complete the
conversion – even if the program indicates that the conversion is ready. If COS server is
disturbed during the upgrade, the conversion stops too early. Look for these signs:
o During the upgrade, the system creates a temporary catalogue file, db.uc, in the COS
server folder; when conversion has finished, the system deletes this file.
o When the upgrading of a 32-bit COS server to 64-bit has finished, the following entry
is written to the COS server log: "Database format conversion succeeded".
l Check from the COS server log that COS server is up and running. You can start and stop
the COS server to check that it keeps running the new version.
l When the COS server is successfully upgraded at master site and replica sites, replica
servers can be set online again if they had been set offline due to upgrading from a version
older than 6.1.x. If using offline replication, an update can be sent from the offline replica.

4.2.6. Upgrading the Applications

l Start the 2021T3R6 installation program and verify that the required components are
selected to be installed.
l Follow the instructions of the installation wizard. The applications are installed in the
program folder c213 (Plant) or co213 (Marine), side by side with existing versions.
l Install the client applications on user workstations, if needed, and verify that the shortcut
opens the CADMATIC desktop of this release.
l If you have custom files in your program, copy the contents from the files of the earlier
version to the files of the new version.

4.2.7. Converting Projects

l Convert the project and library of all projects at the master site of each project. In the
CADMATIC desktop, select the project and then Object > Convert Library And Project.
If the conversion does not start, select Object > Manage COS, browse to Common
Configuration > Security > Security Policies, and check that upgrade to new product version
can be performed by System Administrator.
l If P&ID is in use, the P&ID Diagram Administrator of the master server must start Object
> Manage Diagram Database once. This will automatically convert the SQL schema, if any
schema changes have come with the new version.
Also starting the P&ID application as P&ID Diagram Administrator updates the SQL schema.
If there are replica sites where P&ID replication is used and in SQL settings Replicate P&ID
Diagrams is set to "CoDesigner ON", the P&ID Diagram Administrator of the replica server

Release Notes for CADMATIC Plant/Outfitting and IM 43

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

must start the application once before the users start their applications. This means that
the SQL schema changes coming from the master server are first replicated via COS, and
then the P&ID Diagram Administrator at the replica site applies the changes to the local
SQL database by starting the P&ID application.

4.2.8. User Areas After the Upgrade

l Users can start their areas. The first start prompts the users to re-build the model from
MDL or from COS; if in doubt which option to select, they should select Re-build area via
COS update.

4.2.9. Converting Documents

l Plant Modeller drawings, duct spool documents, pipe spool documents, and weld
documents created before version 2021T2 must be converted to the new document
format. See Upgrading to the New Drafting Platform on page 47.

4.3. CADMATIC eShare Upgrade Notes

Consider the following:
l If you are upgrading from version 2020T2 or older, and if there are many projects in
eShare, reserve plenty of time for the upgrade.
l Disabling projects which are not used actively before the upgrade will reduce the workload,
and thus speed up the process.
l Taking a backup of eShare's data folder (usually %ProgramData%\Cadmatic\eShare) and all
of the project databases before the upgrade is highly recommended.
l If the projects are using IFC importers, take a backup of eShare's bin folder (usually
\Program Files\Cadmatic\eShare\bin) before upgrade. See Changes in IFC Importer on page
45.

Note: If you are upgrading from version 2020T2 or older, eShare will automatically re-publish all
projects after upgrading the server. eShare might not be fully usable while the projects are
being re-published, and high workload can cause slow-down until the publishing finishes.
l Run the setup program to upgrade the server.
l When installing the 3D component on a client computer, Internet Explorer might need to
be closed. In some cases closing the browser might not be enough, as there can be hidden
iexplorer.exe processes that need to be closed using Windows Task Manager.

Release Notes for CADMATIC Plant/Outfitting and IM 44

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l If the Multi-model Import feature is to be used, a new eShare license with an additional
eMerge license is required. The new license is provided free of charge upon request.
l Support for models in JT format requires a separate license.

4.3.1. Changes in IFC Importer

The IFC importer has changed significantly in 2021T3 release. Due to these changes, the
attributes produced by the IFC importer differ from the attributes in previous releases. Some of
the configurations based on imported models using the old IFC importers might break if the
project is re-published. To distinguish between the IFC importers, the new IFC importer uses a
different name and GUID to avoid imports configured to the previous importers from re-
importing models using the new importer. As eShare will not have the old IFC importer anymore
in the 2021T3 release, all previously configured IFC imports will stop working, and models
imported will not be part of project anymore after next re-publish.
There are two options for solving the issue:
l If there are not any configurations in the project based on the attributes created by the
previous IFC import (for example, document links, model categorizations, or model
hierarchies), create a new model importer using the new IFC importer and re-import the
model to eShare using it.
l If re-importing is not desirable, before installing 2021T3 release, make a backup copy of the
following files and folder in \Program Files\Cadmatic\eShare\bin :
l IFCPlugin-2.40 folder
l Cadmatic.EShare.ModelImporterAdapters.IfcModelImporter.dll
l ifc23dd.exe
l ImportCommon-3.67.dll
l ImportSDK-3.67.dll
After installation, paste the copied files to \Program Files\Cadmatic\eShare\bin, and all import
configurations can be used as before. If you did not make a backup copy of the files before
upgrade, the files can be downloaded as a zip package from the CADMATIC Customer Support
Portal.

Note: This process must be repeated during each upgrade from now on if you continue using the
old IFC importer. It is strongly advised to use the new IFC importer for all new projects to
minimize the need for manual work.

Release Notes for CADMATIC Plant/Outfitting and IM 45

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

4.3.2. Changes in eShare App Installer

Due to changes in browser technology and the required dependencies (.NET 5 and WebView2
components), the size of eShare App installer package has unfortunately increased.
To ensure that the application run from the installer functions for all Windows users, the
dependencies must be included in the installer package, as they are not included in Windows by
default. However, as these components are still fairly common, they may have been previously
installed to all computers in some organizations. In such cases an installer package without the
components would suffice. If the administrator is certain that all computers in the organization
have these components installed, the lighter installer can be utilized. Administrator can
substitute the default installer with the lighter installer before distributing it to users.
An individual user can download the lighter installer from the eShare server following the
instructions in eShare documentation.

4.4. CADMATIC eBrowser Upgrade Notes

l Remove the old version of CADMATIC eBrowser from Control Panel > Programs and
Features before installing the new version.
l If an expiring model has been opened earlier with a previous version of eBrowser, it might
not open directly with the latest eBrowser. In this case, close and reopen the model.

Release Notes for CADMATIC Plant/Outfitting and IM 46

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

5. Upgrading to the New Drafting Platform

Version 2021T2 provided a new drafting platform to Plant Modeller documents, including pipe
spool documents, duct spool documents, weld documents, and support documents. This was the
first step in implementing a new 2D platform for CADMATIC products—more features and
usability improvements that relate to 2D functionality are implemented in 2021T3 and upcoming
versions.
The proprietary binary file format (DW) that CADMATIC was using earlier was gradually becoming
outdated, and it was difficult to implement new features on top of it. Now, CADMATIC is using
the Open Design Alliance software (ODA) as the new drafting platform, as this greatly simplifies
interoperability with the de facto standard format, DWG.
When upgrading to 2021T2 or newer, the version upgrade process converts the administration
tools for document production. Existing documents created in previous versions can be
converted one by one as users start to use them in the new version, or they can be converted in
batches using the tool CADMATIC Desktop > Object > Tools > Multi-Project Maintenance.

5.1. Before Version Upgrade

Creating a backup of COS servers before the version upgrade is recommended, as always.
The project conversion that is done after the version upgrade must be able to edit some of the
configuration objects and approval lists. Therefore, administrator of a replication network should
check in advance that the project site which is converted first has access to configuration objects
such as Line widths and Colors.

Release Notes for CADMATIC Plant/Outfitting and IM 47

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

5.2. After Version Upgrade

After upgrading a CADMATIC product and its COS server to the new version, the administrator
must convert the projects to the new version by running the CADMATIC desktop command
Object > Convert Library And Project at each site. This creates the required configuration items
for the new drafting platform.

5.2.1. New Configuration Tools for Administrators

Convert Library And Project creates a number of new configuration objects.
There are several new configuration objects in [library] > Configuration > Common.

Release Notes for CADMATIC Plant/Outfitting and IM 48

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l Drawing styles (defines text styles, dimension styles, and linetypes; CADMATIC linetypes
are replaced with a default set of linetypes and additional ones can be imported from .lin,
.dwg or .dwt files)
l Export Attributes (replaces the attribute export part of Drawing export configuration)
l Layer Configuration (replaces the layer part of Drawing export configuration)
l Lineweights (replaces Line widths)
Document Production > Annotation Property Defaults replaces Drafting Styles.

5.2.2. Changes in Configuration Tools

Convert Library And Project makes the following changes to the configuration.
l The Drawing styles configuration only contains the default CADMATIC styles. Administrator
should check the existing styles and make any required additions. CADMATIC support can
help to convert custom linetypes to .lin files.
l The existing Drafting Styles configurations are automatically recreated as Annotation
Property Defaults configurations. Generally, the configurations have the same names as
before, but if a drafting style for Plant Modeller defines different styles for view and page
annotations, then two separate annotation property objects are created and a suffix in the
name indicates which type they represent. If the library had drafting styles that were
approved for use in the project, then also the corresponding annotation property defaults
are approved for use in the project.

Note: Previously, if the designer modified the properties of the annotation tools, those
changes would be saved in the session. In the new version, the user can still modify

Release Notes for CADMATIC Plant/Outfitting and IM 49

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

the properties in the session, but once the session is closed and re-opened, all the
tools are reset to their default properties.
l The layers in Drawing export configuration are transferred to Layer Configuration. The
administrator should check that the required layers are present. For example, if there
should be a separate layer for each System, the administrator can generate layers for the
currently defined Systems.
l The attributes and hyperlinks in Drawing export configuration are transferred to Export
Attributes.
l Layer styles are edited so that the layers in Layer Configuration are used based on previous
layer names.
l Labeling styles are edited so that the layers in Layer Configuration are used based on the
previous layer names.

5.2.3. Converting Documents

After upgrading to the new version and performing Convert Library And Project, all the existing
documents created in previous versions are still in the old format, and they cannot be published
or edited until they are converted to the new format.
Checking out or opening a previously created document automatically converts the local
document file to the new format. The document conversion regenerates all the views, which
ensures that the views show the 3D model in its current state. Because the views are
regenerated, checking out multiple documents at the same time might take some time.
Therefore, users/administrators might want to do the conversion in smaller batches. Using the
Multi-Project Maintenance tool, administrators can convert documents in one or more projects
at the same time.
Manually converted local documents must be separately checked in to make the conversion
permanent. Converted, checked-in documents have the attribute "Data Version = 2", as shown
below.

If the user discards the converted local document, the document stays in COS as not converted,
and the next time the document is opened the conversion is done again. Discarding the local
converted document happens when the user explicitly cancels the checkout or, in case the user

Release Notes for CADMATIC Plant/Outfitting and IM 50

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

had opened the document for editing without explicitly checking it out first, when the user closes
the open document without saving.

5.2.4. Changes in Menus

l If the file Drw_view.m contains custom menu commands, in the new version they must be
moved to the file EditDrawing_View.m.
l If the files set_operations.m, PmDrw_diml.m and PmDrw_label.m contain custom menu
commands, they must be moved to a COS object whose type is "Custom UI", and the name
of the ribbon where the commands should be added is <Ribbon Name="drawingRibbon">.

5.2.5. Changes in Scripting

All custom scripts that handle documents should be tested to ensure that they work in the new
version. Some of the script functions are working on top of the new documents, but there are
some changes and limitations.
The PEN function and the indices for linewidths still work. If, for example, index 3 points to a
linewidth that is no longer available, the closest valid linewidth replaces it.
Annotations are only visible in the document editor window—they are not visible when a drawing
view is opened in a separate window; if using scripts that prompt the user to select a point from a
drawing view, make sure those scripts use "DW" script externs such as DW_QPOINT instead of
"PM" script externs such as PM_GET_POINT.
Drawing attributes:
If scripts refer to layer numbers, they should be changed to use layer names.
l DW_DRWATTR: int parameter "layer" is replaced with string parameter "layer name".
l DW_GETDRWATTR: int parameter "layer" is replaced with string parameter "layer name".
l DW_GET_CUR_DRWATTR: int parameter "layer" is replaced with string parameter "layer
name".
l DW_GET_CUR_LTYPE: parameter "draw_ends" has been removed.
l DW_LTYPE: parameter "draw_ends" has been removed.
Supported linetypes:
l 1 (Solid)
l 2 (Dotted)
l 3 (Dashed)
l 4 (Long Dashed)

Release Notes for CADMATIC Plant/Outfitting and IM 51

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l 5 (Dotted Dashed)
l 10 (Double Dot Dashed)
l 20 (Revision cloud)
l 32000 (Triple Dot Dashed)
l DW_LAYER: int parameter "layer" is replaced with string parameter "layer name".
l DW_SET_PROPERTIES: parameter "property_value" is string when "property_type" is
"LAYER".
l DW_DEFINE_LAYER: output parameter "layer_id" has been removed.
Text:
l DW_TSIZE: parameters width and spacing have no effect anymore.
Lines and dimensions:
l DW_INSLINE: also text properties can now be edited.
l DW_INSDIMLINE: also dimension properties can now be edited.
Hatching:
l DW_HATCH_FACE: parameter "face_visualize" has no effect.
Groups:
l DW_SETLINEATTRINGROUP: return values are now
int 0 Attributes changed successfully
int -1 Error or user canceled
Miscellaneous:
l DW_QUERY_DRW_ATTRIBUTES: LAYER_TAG "lay"; if TYPE_TAG's value is "lay" then VALUE_
TAG's value contains the layer name.
Functions that are deprecated in drafting in Plant Modeller 2021T2:
l DW_SINGLE_PICK
l DW_START_HOLE
l START_HOLE
l DW_FACE_GROUP
l DW_HOLE_GROUP
l DW_GETDRWPICKMASK
l DW_SET_PICK_MAX_DIST
l DW_EDIT_DIM

Release Notes for CADMATIC Plant/Outfitting and IM 52

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

l DW_LIMITS
l DW_REFPOLY
l DW_INSNODE
l DW_DELNODE
l DW_EDITNODE
l DW_DUMPGROUPTOFILE
l DW_DUMPGROUPTOSYMBOL
l DW_EDITOR
l DW_SET_EDITOR
l DW_GET_EDITOR
l DW_GETPOINTOFINTEREST
l DW_NODE
l DW_SETSYMDUMPATTR
l DW_SETSYMDUMPANIMATION
l DW_SETSYMDUMPPEN
l DW_SETSYMDUMPCOLOR
l DW_SETSYMDUMPLAYER
l DW_ATTRIBUTE
l DW_DUMP
l DW_GET_LOCAL_COORDINATES
l DW_REF_VIEW
l DW_GET_REF_VIEW
l DW_GET_REF_VIEWS
l DW_DEL_REF_VIEW
l DW_FIND_DEL_REF_VIEW
l DW_GETREFVIEW_COORDINATES
l DW_SETREFVIEW_COORDINATES
l DW_GETREFVIEW_LIMITS
l DW_SETREFVIEW_LIMITS
l DW_VIEWUSRPRM
l DW_GET_ROOT_GROUP
l DW_GETDRWCLIENTDATA

Release Notes for CADMATIC Plant/Outfitting and IM 53

Release 2021T3R6
CADMATIC SOFTWARE SOLUTIONS

5.3. Known Problems and Limitations

These problems and limitations are known to exist in the current release of the new drafting
platform.
l Revision Control – In the revision control tool that can be opened from Views > Revision
Control, the Annotate View command does not work as well as it used to because
annotations are not visible in wireframe views. The revision control tool is being completely
revised, and user organizations that use this tool a lot should wait for the main release
where the revised tool is available.
l Line Properties – The line types that in the old format had settings for Symbolic Line
Segment are not supported in the new drafting platform. The conversion changes the
polylines into single-segment lines that can still be moved, copied, deleted, and rotated, if
needed. If a line type that uses similar polylines is needed in the new version, it can be
created via shape import from a .lin, .dwg or .dwt file.
l Dimension Properties – In some cases, it can happen that dimension text that had been
rotated before the conversion does not react when you try to rotate it after the
conversion. This is due to the differences in the settings of the old format and the new
format. To correct this problem, start editing the rotated dimension and re-set the
Dimension Properties text option Text placement to "Use default position". After this, all
the settings should behave normally.
l Reference Drawings – If a converted document has reference drawings, visually they look
just like they did before the conversion, but their scaling values have been reset. For
example, if X Scale was 2.0 and Y Scale was 1.0, after the conversion both are 1.0, but the
drawing still looks stretched in x-direction. The converted reference drawings should work
normally, but if the incorrect scaling values are seen as a problem, the values can be
corrected by detaching and then re-attaching the reference drawings.

Release Notes for CADMATIC Plant/Outfitting and IM 54

Release 2021T3R6