Unique Identification or Search Criteria

For identifying exchanged objects, the XPDMXML file exchanged between 3DEXPERIENCE platform and X-PDM must always contain the UniqueID element for each object, with the following attributes:

  • XID is the stable object identifier maintained by 3DEXPERIENCE platform during the whole life cycle of an 3DEXPERIENCE platform object.
  • External is the stable identifier for object exchange.
Warning:
  • UniqueID must never be shared by different objects. Both 3DEXPERIENCE platform and X-PDM, ensures that each object has its own distinct UniqueID.

  • The value of External received from X-PDM is stored by 3DEXPERIENCE platform in a coexistence Context. Transfer of an object from X-PDM to 3DEXPERIENCE platform and subsequently from 3DEXPERIENCE platform to X-PDM maintains the value of External only if it is executed in the same Context.

    For more information about coexistence Contexts, see Identify The Exchange Channel.

This page discusses:

From 3DEXPERIENCE platform to X-PDM

The Engineering Exchanges Adapter exports External with either the value of XID (if it is an 3DEXPERIENCE platform authored object) or with the value coming from X-PDM (if it is an X-PDM authored object) and exports XID in both cases.

The possible cases are as following:

  • 3DEXPERIENCE platform authored object:

    <UniqueID External="84442098CEED0D7C05053135526064CD050712D1" XID="84442098CEED0D7C05053135526064CD050712D1" locationOfControl="V6" />

  • X-PDM authored object:

    <UniqueID External="X-PDM_authored_ID" XID="84442098CEED0D7C05053135526064CD050712D1" locationOfControl="XPDM" />

From X-PDM to 3DEXPERIENCE platform

The Engineering Exchange Adapter considers only External, while creating a new object or while reconciling an existing object. The XID is always ignored.

The possible cases are as following:

  • 3DEXPERIENCE platform authored object:

    <UniqueID External="84442098CEED0D7C05053135526064CD050712D1" XID="84442098CEED0D7C05053135526064CD050712D1" locationOfControl="V6" />

    Or

    <UniqueID External="84442098CEED0D7C05053135526064CD050712D1" locationOfControl="V6" />

  • X-PDM authored object:

    <UniqueID External="X-PDM_authored_ID" locationofcontrol="XPDM />

    Or

    <UniqueID External="X-PDM_authored_ID" XID="84442098CEED0D7C05053135526064CD050712D1" locationOfControl="XPDM" />