powered by CADENAS

Manual

Manual

3.3.10.3. Teamcenter - NX

How does the PDM integration work?

During the export form PARTsolutions to a CAD system an inquiry is sent to the LinkDB, whether the part is already available:

  • If yes, the part is automatically copied from the server into the local cache and opened in the CAD system.

  • If not, the part is created in the local cache and form there "checked into" Teamcenter. Finally this information is saved in the LinkDB.

Preconditions and particularities

Those folders where parts shall be checked in, have to be already available in Teamcenter at checkin.

The file name can either come from PARTsolutions or from Teamcenter. This is adjustable.

See below under ItemID.

Installation

Please carry out the Teamcenter installation on the basis of the Teamcenter manual. For the interface installation please select the Teamcenter package in the PDM category within the installation routine. Alternatively you can download the interface from the internet.

Activate PDM interface:

  • $CADENAS_SETUP/ifacecommon.cfg

    "AppBeforeCreate" and "AppAfterCreate" have to be commented in.

    [CreationOptions]
    AppBeforeCreate=GetObject("pdm.callbackCheckinout").AppBeforeCreate
    AppAfterCreate=GetObject("pdm.callbackCheckinout").AppAfterCreate

  • $CADENAS_SETUP/ifnxteamcenter.cfg

    ACTIVE_CONDITION has to be set on "true".

    [PLM]
    ACTIVE_CONDITION=true

Configuration

The Teamcenter interface configuration is carried out under $CADENAS_SETUP/ifnxteamcenter.cfg.

  • ItemID

    [CreationOptions]
    TC_ItemId=

    If the ItemID shall come from Teamcenter, then leave this key empty.

    The following example shows, how you can define the ItemID yourself:

    TC_ItemId=?GetObject("iface.calcnameservice").start(0).Format("<ATTR(NB)>").
     alnum("").value()

    The display name in the following figure is composed of TC_ItemId and TC_ItemName (here in this example NB=standard name).

    "TC_ItemId" assigned from Teamcenter and "TC_ItemName" from NB

    "TC_ItemId" assigned from Teamcenter and "TC_ItemName" from NB

    Detailed information how you can individually adjust the ItemID is found under Section 2.2.1.4, “Variable values - functions ” or in the examples of the configuration file.

  • Revision

    [CreationOptions]
    TC_ItemRevision=

    If nothing is declared, then revision “A“ is used by default.

  • ItemName

    [CreationOptions]
    TC_ItemName=

    If nothing is declared for TC_ItemName, then this value is set with TC_ItemID.

    Exemplary entry:

    TC_ItemName=?GetObject("iface.calcnameservice").start(0).Format("<GenNAME(26)>").
     alnum("").value()

    For ItemName the standard name (GENNAME) is set.

  • ItemDescription

    [CreationOptions]
    TC_ItemDescription=

    Exemplary entry:

    TC_ItemDescription=?GetObject("iface.calcnameservice").start(0).
     Format("<ATTR(LINA)>").value()
    

    For ItemDescription the bom name is set.

  • ItemType

    [CreationOptions]
    TC_ItemType=

    Here you can define the ItemType for parts from PARTsolutions. If this key is not defined, then the type “Item“ is used.

  • TargetFolder

    [CreationOptions]
    TC_TargetFolder=

    Here you can define the storage folder for parts from PARTsolutions. To that place parts are moved, after they have been checked into Teamcenter.

    Example:

    TC_TargetFolder=Home\BaseFolder01\SubFolder01

    There is no automatic creation of folders.

    If folders shall be automatically created, then <TC_HookService_MoveToNewFolder_...> has to be used.

    As of V9.05 the path declaration is made in the same format as with the other Teamcenter interfaces.

    [Caution] Caution

    The following 3 keys are needed, when the key under [CreationOptions] -> TC_TargetFolder is set. (Login data for the Teamcenter API: user name, password, host name). They also can be used for other Teamcenter HookService methods.

    TC_HookService_Login_USER=

    Only a value (no categories) per key is supported. The stated user has to have access right on the objects of that user logged in to NX for TC.

    TC_HookService_Login_PASS=

    Only a value (no categories) per key is supported.

    TC_HookService_Login_HOST=

    If moving is not wanted, comment out the key TC_ItemDescription. Then the folder “Newstuff“ is used by default.

  • LinkDB ReturnMapping

    Via LinkDB-ReturnMapping, PDM attributes can be mapped to link database fields.

    At first, in the block [AttributeMapping(is3d)], the block for the actual LinkDB mapping has to be declared (as usual).

    [AttributeMapping(is3d)]
    Attr_Content_00=LINKDB_RETURN_MAPPING
    Attr_Section_00=LINKDB_RETURN_MAPPING

    Now in NX, start PARTdataManager as usual and export the parts into the CAD system. Now the parts are automatically exported to Teamcenter. <ERP_COLUMN_NAME> or LINKTABLE.<ERP_COLUMN_NAME> have to be an existing VARCHAR column!

    Example:

    [LINKDB_RETURN_MAPPING(is3d)]
    ERPTABLE.<ERP_COLUMN_NAME>=?"'%TC_ItemId%'"

    ERPTABLE.<ERP_COLUMN_NAME> specifies table and column, the value the placeholder to be used. Thereby the ItemId for example (which is possibly created during the generation in Teamcenter) can be saved in the LinkDB.

    Supported placeholders for ERPTABLE.<ERP_COLUMN_NAME> are:

    • %TC_ItemId%

    • %TC_ItemRevision%

    • %TC_ItemName%

    • %TC_ItemDescription%

    • %TC_TargetFolder%

    • %TC_ItemType%

    After a new creation of parts the project has to be reloaded in PARTdataManager in order for the PDM values to be displayed.

  • Native Checkin

    [CreationOptions(isNatCheckin):include(CreationOptions)]
    
    PLM_usePlmtable2=1
    
    #:CHANGE;NEVER
    FileName=?_METAOBJ.cadident
    
    #:HELP; default; The Teamcenter ItemID.
    TC_ItemId=?_ATTR("db_part_no")
    
    #:HELP; default; The Teamcenter ItemRevisionID.
    TC_ItemRevisionId=?_ATTR("db_part_rev")

    ItemId and ItemRevisionId are stored in the PLMTable or in the project in order to retrieve the part.

Procedure

In order to launch NX with the Teamcenter environment, at first Teamcenter has to be started. Hereto double-click on the logo for example.

When Teamcenter is started please login.

After login NX has to be opened from Teamcenter. Hereto in Teamcenter, click on the Unigraphics / NX button.

Now in NX, start PARTdataManager as usual and export the parts into the CAD system. Now the parts are automatically exported to Teamcenter.

The following figure shows a part with the Teamcenter-ID '000216', both in Teamcenter and in the PARTdataManager.

For further additional functions see Section 3.3.10.5, “Teamcenter additional functions (teamcenter_public_api.vbb) ”.