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 two attributes:

  1. XID is the stable object identifier maintained by 3DEXPERIENCE platform during the whole life cycle of an 3DEXPERIENCE platform object
  2. External is the stable identifier for object exchange.

    For exchange of EBOM Parts and Documents, External is the identifier of the object revision family.

This task shows you how to:

From 3DEXPERIENCE platform to X-PDM

The E-BOM Exchange Adapter exports XID in any case, and 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. Here are the possible cases:

  1. Object created in 3DEXPERIENCE platform:

    • First object in the revision family: External is identical to XID

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

    • Object other than first object in the revision family: External is different from XID

      <UniqueID External="84442098CEED0D7C05053135526064CD050712D1" XID="84442098CEED0D7C05053135526064CD050FF0E4" />

  2. Object first created in X-PDM:

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

    Note: The value of External is stored in 3DEXPERIENCE platform attribute UniqueID for Part and Documents and UniqueInstanceId for Engineering BOM Exchange relationships.

From X-PDM to 3DEXPERIENCE platform

The E-BOM Exchange Adapter considers only External, when creating a new object or updating an existing object. XID is ignored if it is sent back to 3DEXPERIENCE platform from X-PDM. Here are the possible cases:

  1. Object first created in 3DEXPERIENCE platform:
    <UniqueID External="84442098CEED0D7C05053135526064CD050712D1" XID="84442098CEED0D7C05053135526064CD050712D1" />

    OR

    <UniqueID External="84442098CEED0D7C05053135526064CD050712D1" />

  2. Objects first created in X-PDM:

    <UniqueID External="X-PDM_authored_ID" />

  3. Objects first created in X-PDM with an 3DEXPERIENCE platform round-trip through which X-PDM would have stored XID

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

    Note: The value of External is compared with 3DEXPERIENCE platform attribute UniqueID for parts and documents and UniqueInstanceId for EBOM relationships. Search for parts and documents is also based on RevisionName.