PTC Creo Parametric 3.

0
J-Link Release Notes
Datecode M050

Copyright 2015 PTC Inc. and/or Its Subsidiary Companies. All Rights Reserved.
User and training guides and related documentation from PTC Inc. and its subsidiary companies (collectively
"PTC") are subject to the copyright laws of the United States and other countries and are provided under a
license agreement that restricts copying, disclosure, and use of such documentation. PTC hereby grants to the
licensed software user the right to make copies in printed form of this documentation if provided on software
media, but only for internal/personal use and in accordance with the license agreement under which the
applicable software is licensed. Any copy made shall include the PTC copyright notice and any other
proprietary notice provided by PTC. Training materials may not be copied without the express written consent
of PTC. This documentation may not be disclosed, transferred, modified, or reduced to any form, including
electronic media, or transmitted or made publicly available by any means without the prior written consent of
PTC and no authorization is granted to make copies for such purposes.
Information described herein is furnished for general information only, is subject to change without notice,
and should not be construed as a warranty or commitment by PTC. PTC assumes no responsibility or liability
for any errors or inaccuracies that may appear in this document.
The software described in this document is provided under written license agreement, contains valuable trade
secrets and proprietary information, and is protected by the copyright laws of the United States and other
countries. It may not be copied or distributed in any form or medium, disclosed to third parties, or used in any
manner not provided for in the software licenses agreement except with written prior approval from PTC.
UNAUTHORIZED USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVIL
DAMAGES AND CRIMINAL PROSECUTION. PTC regards software piracy as the crime it is, and we view
offenders accordingly. We do not tolerate the piracy of PTC software products, and we pursue (both civilly
and criminally) those who do so using all legal means available, including public and private surveillance
resources. As part of these efforts, PTC uses data monitoring and scouring technologies to obtain and transmit
data on users of illegal copies of our software. This data collection is not performed on users of legally
licensed software from PTC and its authorized distributors. If you are using an illegal copy of our software
and do not consent to the collection and transmission of such data (including to the United States), cease
using the illegal version, and contact PTC to obtain a legally licensed copy.
Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright
notice, of your PTC software.

UNITED STATES GOVERNMENT RESTRICTED RIGHTS LEGEND

This document and the software described herein are Commercial Computer Documentation and Software,
pursuant to FAR 12.212(a)-(b) (OCT95) or DFARS 227.7202-1(a) and 227.7202-3(a) (JUN95), and are
provided to the US Government under a limited commercial license only. For procurements predating the
above clauses, use, duplication, or disclosure by the Government is subject to the restrictions set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software Clause at DFARS 252.2277013 (OCT88) or Commercial Computer Software-Restricted Rights at FAR 52.227-19(c)(1)-(2) (JUN87),
as applicable. 01012015
PTC Inc., 140 Kendrick Street, Needham, MA 02494 USA

Contents

About This Guide ........................................................................................................7

Summary of Technical Changes ...................................................................................9
Critical Technical Changes ..................................................................................10
Miscellaneous Technical Changes .......................................................................14

About This Guide

This document provides release-specific information for J-Link for PTC Creo
Parametric 3.0. It describes new methods in J-Link and also includes critical
functions that require investigation of existing applications and adjustment of
existing code.
Documentation for J-Link
J-Link documentation comes in the following forms:

API Wizard in HTML format

J-Link Users Guide in PDF format

Reference Documents page at http://www.ptc.com/appserver/cs/doc/refdoc.

jsp
(Choose the product or document type)

The API Wizard and the J-Link Users Guide are on thePTC Creo Parametric
DVD-ROM. You can view the API Wizard with your Internet browser. To view
and print the PDF book, you must have Acrobat Reader installed. PTC welcomes
your suggestions and comments on its documentation. Send comments
electronically to:
MCAD-documentation@ptc.com

1
Summary of Technical Changes
Critical Technical Changes .........................................................................................10
Miscellaneous Technical Changes ..............................................................................14

This chapter describes the critical and miscellaneous technical changes in PTC
Creo Parametric 3.0 and J-Link. It also lists the new and superseded functions for
this release.

Critical Technical Changes

This section describes the changes in PTC Creo Parametric 3.0 and J-Link that
might require alteration of existing J-Link applications.

APIWizard Available on PTC.com

The latest version of J-Link APIWizard is available at www.ptc.com/support/
apiwizard.htm.

No Support for Applet Based APIWizard

The applet based APIWizard for J-Link will not be available in future releases.
PTC recommends using the non-applet based version of the APIWizard.

Non-Applet Based Version of the APIWizard

To open the non-applet based version of the J-Link APIWizard, point your
browser to:
<creo_jlink_loadpoint>\jlinkdoc\manual0\loadToolkitDoc.html

The non-applet based version of the J-Link APIWizard has enhanced search
capabilities. The new search options enable you to search for only global methods
and exceptions, in addition to searching for all classes and methods.

Change in Behavior of pfcServer.Server.

IsObjectModified
From Creo Parametric 2.0 M040 onward, the behavior of the method
pfcServer.Server.IsObjectModified has been fixed. The method now
returns the value false to indicate one of the following statuses for the specified
object:

the object was only saved, but never uploaded

the object was only uploaded, but never checked in

Change in Behavior of pfcTable.Table.

CheckIfIsFromFormat
The method pfcTable.Table.CheckIfIsFromFormat did not correctly
check if the drawing table was created using the drawing format. The method
would return FALSE, if the first segment of the table was not on the current sheet

10

PTC Creo Parametric 3.0 J-Link Release Notes

in the Creo Parametric user interface, even though the table was created using the
drawing format. This behavior has been fixed in Creo Parametric 2.0 M120. The
method now checks and returns the correct boolean value.
As in the previous releases, the method
pfcTable.Table.CheckIfIsFromFormat ignores the value provided in
the input argument SheetNumber.

Change in Directory Structure for PTC Creo

Installation
From PTC Creo 3.0 onward, the directory structure for PTC Creo installation has
changed from:

<creo_loadpoint>\Parametric to <creo_loadpoint>\
<datecode>\Parametric.
<creo_loadpoint>\Common Files\<datecode> to <creo_
loadpoint>\<datecode>\Common Files

Change in Integer Values for Enumerated Data Type

ComponentType
The integer values for enumerated data type ComponentType were shifted by 1
and did not reflect the actual values. From Creo Parametric 2.0 2.0, M120 onward,
this behavior has been fixed. If your application code uses these values, you must
rebuild your application.

Digital Rights Management Retired

From PTC Creo Parametric 3.0 onward, Digital Rights Management (DRM) is no
longer supported. J-Link applications that check the DRM permissions will have
to be updated.

Documentation Updated for pfcServer.Server.

IsObjectModified
The documentation for the method
pfcServer.Server.IsObjectModified has been updated in PTC Creo
3.0 M010. This method returns true if the object was modified locally.

Summary of Technical Changes

11

Layout Model Type

From PTC Creo 3.0 M010 onward, the object pfcModel.ModelType contains
an additional value MDL_CE_SOLID that represents models of type Layout. JLink methods will only be able to read models of type Layout, but will not be able
to pass Layout models as input to other methods. To work with Layout models,
you must rebuild your existing J-Link applications.

No Support for Boundary Box Type of Simplified

Representation
From PTC Creo Parametric 3.0 onward, the boundary box type of representation
specified by the following values are no longer supported:

SIMPREP_BOUNDBOX_REP in the enumerated data type SimpRepType

SIMPREP_BOUNDBOX in the enumerated data type SimpRepActionType

Retrieving Solids in a PTC Creo Parametric Session

Linked to PTC Windchill
You must retrieve solid models in a PTC Creo Parametric session, which is linked
to PTC Windchill, only after you create a new workspace. If you retrieve the
models before creating the workspace, the models would be erased from the PTC
Creo Parametric session.

Support for Constraint Creation Methods

You cannot create constraints using the J-Link applications. The following
methods are not supported. These methods will be supported in a future release:

12

pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneTh
roughConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneNormal
Constraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneParal
lelConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneTan
gentConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneOffset
Constraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneOffset
CoordSysConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneAngle
Constraint_Create

PTC Creo Parametric 3.0 J-Link Release Notes

pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneSec
tionConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneDe
faultXConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneDefaul
tYConstraint_Create
pfcDatumPlaneFeat.pfcDatumPlaneFeat.DatumPlaneDe
faultZConstraint_Create
pfcDatumAxisFeat.pfcDatumAxisFeat.DatumAxisCon
straint_Create
pfcDatumAxisFeat.pfcDatumAxisFeat.DatumAxisDimension
Constraint_Create
pfcDatumPointFeat.pfcDatumPointFeat.DatumPointPlace
mentConstraint_Create
pfcDatumPointFeat.pfcDatumPointFeat.DatumPointDimen
sionConstraint_Create
pfcCoordSysFeat.pfcCoordSysFeat.DatumCsysOriginCon
straint_Create
pfcCoordSysFeat.pfcCoordSysFeat.DatumCsysDimension
Constraint_Create
pfcCoordSysFeat.pfcCoordSysFeat.DatumCsysOrientMove
Constraint_Create

Support for Feature Subclasses

From PTC Creo Parametric 3.0 onward, only the following subclasses of the class
pfcFeature are supported:

pfcComponentFeat
pfcCoordSysFeat
pfcCurveFeat
pfcDatumAxisFeat
pfcDatumPlaneFeat
pfcDatumPointFeat
pfcRoundFeat

If your applications check the type of feature using the type of class, then you
must update your existing code to use the method
pfcFeature.Feature.GetFeatType. The method
pfcFeature.Feature.GetFeatType returns the type of feature.

Summary of Technical Changes

13

Support for Multi-CAD Assemblies

Multi-CAD assemblies are not supported in J-Link. The methods provided in PTC
Creo Object TOOLKIT Java support multi-CAD assemblies. Refer to PTC Creo
Object TOOLKIT Java User's Guide for information on multi-CAD assemblies.

Miscellaneous Technical Changes

The following changes in PTC Creo Parametric 3.0 can affect the functional
behavior of J-Link. PTC does not anticipate that these changes cause critical
issues with existing J-Link applications.

Configuration Flag to Include Annotations During

Export of PTC Creo Parametric Models
From PTC Creo Parametric 3.0 onward, a new configuration flag EXPORT_
INCLUDE_ANNOTATIONS has been added. The flag includes annotations during
the export of PTC Creo Parametric model to the specified format.

Display Style for Views

From PTC Creo Parametric 3.0 M010 onward, a new display type DISPSTYLE_
SHADED_WITH_EDGES has been added to the enumerated data type
DisplayStyle. This option allows you to display the model as a shaded solid
along with its edges.

14

PTC Creo Parametric 3.0 J-Link Release Notes