www.Tecnomatix.

com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

Updates to eMPower APIs (7.5)

Copyright 1984 2005 by Tecnomatix. All rights reserved.

This document contains proprietary information and is protected by copyright. No part of this document may be reproduced, stored in a
retrieval system, translated, transcribed, or transmitted, in any form or by any means, without the prior explicit written consent of
Tecnomatix Technologies Ltd.
Tecnomatix, and the Tecnomatix logo are registered trademarks of Tecnomatix Technologies Ltd. eMPower, the eMPower logo,
Realizing Your Manufacturing Vision and Assembly Module, eBOP Browser, eM-Arc, eM-Assembler, eM-Body-Shop, eM-Cables,
eM-Calibration, eM-Designer, eM-Drill, eM-Engineer, eM-Fixtures, eM-Flow, eM-Gauge, eM-Glue, eM-Human, eM-Inspect,
eM-Inspector, eM-Laser, eM-Layout, eM-Line, eM-Machining, eM-Martel, eM-Measure, eM-OLP, eM-Paint, eM-Performance,
eM-Planner, eM-Plant, eM-PLC, eM-Press, eM-ProbeCAD, eM-Qualify, eM-RealNC, eM-Reports, eM-Reverse, eM-ROSE, eM-Seal,
eM-Sequencer, eMServer, eM-Shipweld, eM-Simulate, eM-Spot, eM-TolMate, eM-Uman, eM-Viewer, eM-Weld, eM-WI Browse,
eM-WI Creator, eM-Workplace, PLMXML Gate, Process Designer, Process Simulate, Task Description Language, TDL are trademarks of
Tecnomatix Technologies Ltd. All other product names or brand names are trademarks or registered trademarks of their respective owners.
Tecnomatix Technologies Ltd.
Delta House, 16 Aba Eben Avenue
Herzliya 46120
Israel

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

Updates to the eM-Planner API in v7.5

The sections below describe all the changes in the eM-Planner API, updating it from version 7.2 to 7.5.
While this document mentions the new methods and interfaces, it does not provide an in-depth
description of the changes or explanations on how to use the new API functionality - these are included
in the eM-Planner API Manual to be published in the near future.

1. Specific Changes in Libraries

We added a new calculated field "Ex_isValidExpressionValue" for variant sets and variant filters.
It has much better performance then the function: isValidExpression. It can be retrieved on objects of
types VariantSet or VariantFilter.

1.1.

EmpActions
No change.

1.2.

EmpAppServices

Interface
IEmpNodesServices

1.3.

EmpApplicationData
No change.

1.4.

Method
AddSecondaryIds
RemoveAllSecondaryIds
CreateScopeFlowsTo
RemoveSecondaryIds
SetSecondaryIds
GetSecondaryIds
GetObjectsBySecondaryId
CreateExternalDocuments

EmpCore
No change.

Status
New
New
New
New
New
New
New
New

The change

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

1.5.

EmpIntegration

Interface
IEmpImportCollection

Method
Property - CheckOut

Status
New

The change

Interface
IEmpGeneralTraversal

Method
Property -VisitOnceInAllRoots

Status
New

The change

IEmpTypeCollector

Property -VisitOnceInAllRoots

New

Method
AreUsersActive

Status
New

AreGroupsActive

New

GetAdministratorsGroup

New

1.6.

EmpModel
No change.

1.7.

EmpServerEnv
No change.

1.8.

1.9.

EmpTraversals

EmpVersions
No change.

1.10. EmpIconMgmt
No change.

1.11. EmpTypeMgmt
No change.

1.12. EmpUserMgmt
Interface
IEmpUserManager

The change

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

1.13. EmpExpressionDomain
New Library.

1.14. EmpVariantDomain
Interface
IEmpVariantFilterEngine

Method
FindPublicVariantSetsByExpr
ession

Status
New

The change

Interface
IEmpDataEventsHandler

Method
Advise3

Status
New

The change

IEmpDataEvents3

Same as IEmpDataEvents2

IEmpDataEventsHandler

OnTransactionEnded

New
Interface
New

1.15. EmpEnvironment
No change.

1.16. EmpDataEvents

1.17. EmpApplication
Units support added
Interface
Method
IEmpAppOptions GetUnitConversionFactor

Status
New

GetUnitName

New

GetUnitPrecision

New

GetTimeDigitsAfterDecPoint

New

SetTimeDigitsAfterDecPoint

New

GetLinearDigitsAfterDecPoint

New

SetLinearDigitsAfterDecPoint

New

GetAngularDigitsAfterDecPoint

New

SetAngularDigitsAfterDecPoint

New

GetMassDigitsAfterDecPoint

New

The change

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

SetMassDigitsAfterDecPoint

New

GetTimeUnits

New

SetTimeUnits

New

GetLinearUnits

New

SetLinearUnits

New

GetAngularUnits

New

SetAngularUnits

New

GetMassUnits

New

SetMassUnits

New

1.18. EmpViewerInterface
No change.

1.19. EmpDataEvents
No change.

1.20. EmpAppBase
No change.

1.21. EmpAppClientManager
No change.

1.22. EmpTreeControl
Tree sorting added
Interface
IEmpTreeControl

Method
get_SortTreeByCaption

Status
New

put_SortTreeByCaption

New

SaveTreeSortedByCaption

New

The change

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

1.23. EmpClientCommands
No change.

1.24. EmpPropertiesControl
No change.

1.25. EmpInfoViewer
No change.

1.26. EmpTypeLibrary
Added EmpSecondaryIdData.
Added value "CadSys_JT" to enum EmpEnumCadSystemType

1.27. EmpGUIBase
Units support added.
Interface
Method
IEmpOptions
UpdateTimeUnits

Status
New

UpdateMassUnits

New

UpdateLinearUnits

New

UpdateAngularUnits

New

UpdateTimeDigitsAfterDecPoint

New

UpdateMassDigitsAfterDecPoint

New

UpdateLinearDigitsAfterDecPoint

New

UpdateAngularDigitsAfterDecPoint

New

The change

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

Updates to the eM-Engineer API (Engineer.NET API) in v7.5

The sections below describe all the changes to the Engineer.NET API, updating it from version 7.2 to
7.5. While this document mentions the new methods and interfaces, it does not provide an in-depth
description of the changes or explanations on how to use the new API functionality - these are included
in the eM-Engineer API Manual which is part of the 7.5 release.

1.1.

Planning Objects

Class

Status

ITxPlanningObject
TxPlanningMfgFeature
TxPlanningObject
TxPlanningOperation
TxPlanningPart
TxPlanningPartPrototypeAssignment
TxPlanningPLP
TxPlanningPrototypeAssignment
TxPlanningResource
TxPlanningToolPrototypeAssignment
ITxEmsServicesProvider
ITxPlatformServicesProvider
TxEmsServicesProvider
TxProcessModule
TxObjectList

New
New
New
New
New
New
New
New
New
New
New
New
New
New
New
Function
New
Functions

TxSelection

1.2.

Method

PlanningRepresentations
GetPlanningItems
GetAllItems
GetOrderedItems
TotalCount
PlanningCount

Robotics

Class

Status

ITxRobotSimulationController
TxRobotSimulationEngine

New
New

TxRobotExternalAxisData

New

TxRoboticLocationOperationMotionParameters

New

Method

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

TxRoboticViaLocationOperation

TxWeldLocationOperation
TxKinematicLink

TxWeldOptions
TxOLPUtilities

ITxRoboticLocationOperation

1.3.

New
Functions
New
Functions
New
Function

New
Functions
New
Functions
New
Function

ParentJoint
TxApproachAxis
Approach
ApproachAxisPermittedDeviationAngle
ThirdAxisPermittedDeviationAngle
CreateRobotSimulationController
CreateDefaultRobotSimulationController
RobotExternalAxesData

Exceptions

Class

Status

TxPrototypeNotAssignedToOperationException

New

1.4.

DisplayMode
RobotExternalAxesData
IsProjectionValid
RobotExternalAxesData
DisplayMode

Method

Layout

Class

Status

Method

New
Functions
New
Functions

constructor was changed.

IsUseDefaultToolbars
IsUseDefaultContextMenus
Load()
Store()

Class

Status

Method

TxGraphicViewer
TxViewersManager
TxCamera

New
New
New
New
Function

ViewersManager

TxLayoutCreationData
TxLayoutManager

1.5.

TxApplication

Graphic Viewer

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

1.6.

Engineering.UI

Class

Status

TxFlexGrid
TxImageManipulator
TxImageProvider
TxPickListener
TxStateImageManager
TxTypeFilterValidator
ITxValidador
TxObjComboBoxCtrl

New
New
New
New
New
New
New
New
Function

TxObjEditBoxCtrl

New
Functions

HideErrorWindow
HideErrorWindow
ShowErrorWindow
SetValidator

Class

Status

Method

TxManipulatorSymbolElementData
TxMfgFeature
TxMeasurementsCalculator
MeasurementValues

New
New
New
New
New
Functions
New
Functions

1.7.

Miscellaneous

TxLabel
TxBoundingBox

TxColor
TxProjectionInvalidData
ITxDisplayableObject
ITxGroup
TxManipulator
TxWeldPoint

Method

New
Functions
New
Function
New
Function/s
New
Functions
New
Functions
New
Function

Implement ITxDisplayableObject
TxBoundingBoxesIntersectionState
DoesIntersect
operator==
override Equals
override GetHashCode
TxProjectionInvalidReason
DisplayMode
New Event:
DetailedRepresentationRetrieved
SetElementColor
TxDisplayMode DisplayMode
WeldLocationOperations

www.Tecnomatix.com

Tecnomatix Technologies, Ltd.

Delta House 16 Hagalim Ave.
Herzlia, Israel 46120
Tel: 972-9-9594777
Fax: 972-9-9544402

Updates to Standard Interfaces (7.5)

The sections below describe the changes in eMPower's standard import/export formats, updating it
from version 7.2 to 7.5. More in-depth information may be found in the eMPower Administration Guide.

1.1.

PPD Format

In version 7.5 a bug in the PPD export/import was fixed. Before the fix, the PPD failed whenever it
encountered External IDs with special characters. Now, such cases are handled by the system, and
the special characters receive special treatment, as described below:
PPD new behavior:
If an externalID contains special characters (such as \ , ", . or ' ), the system appends quote marks
before and after the string.
When the special character is: " or \ the system adds an extra \ before it.
This behavior takes places in the "ref" fields and in the start line of the element.
There are no changes for cases when the externalID contains no special character.
Examples:
Start of element:
externalID as C:\SYSTEMROOT\ABC\3D\Parts\assembly_21.asm
will appear in the file as "C:\\SYSTEMROOT\\ABC\\3D\\Parts\\assembly_21.asm"
PM_UPDATE PmCompoundPart "C:\\SYSTEMROOT\\ABC\\3D\\Parts\\assembly_21.asm"
Vector Ref field:
if the object has two children with the following externalIDs:
q._inf_1_8_ and C:\SYSTEMROOT\ABC\3D\Parts\\03
the string in the file will be:
children = "q._inf_1_8_","C:\\SYSTEMROOT\\ABC\\3D\\Parts\\03"
Single Ref field:
Assuming a layout of an object has the following externalID:
C:\SYSTEMROOT\ABC\3D\Parts\assembly_21.asm_lt
it will appear as:
layout = "C:\\SYSTEMROOT\\ABC\\3D\\Parts\\assembly_21.asm_lt";

1.2.

XML Import/Export Format

No change in the XML Import/Export format.