Documentation COLNEO GmbH

Global

Members

# constant eDataType

Supported data types.

View Source gom/gom.js, line 31

# constant eDomain

Supported domains

View Source gom/gom.js, line 13

Methods

# async mapToExternalIDs(internalIDs) → {Promise.<Record.<string, (string|null)>>}

Maps internal object IDs to their corresponding external IDs.

This method intentionally wraps and extends desiteAPI.mapToExternalIDs. It should be used instead of the Desite API method whenever fallback behavior is required.

Mapping logic:

  1. Attempt to map all internal IDs using desiteAPI.mapToExternalIDs
  2. For IDs without a direct external mapping:
    • If the object is part of a composite (cpIsPartOfComposite === true), inherit the external ID of its parent object
    • Otherwise, fall back to using the internal ID itself

This guarantees that every provided internal ID appears in the result object, even if no external ID exists.

Parameters:
Name Type Description
internalIDs Array.<string>

Array of internal object IDs to map
Since:
  • 2025-12-16 RM

View Source adapter/AdapterDesite_34_40.js, line 28

A promise resolving to an object where:

  • keys are internal IDs
  • values are external IDs, inherited parent external IDs, the internal ID itself, or null if no mapping could be resolved
Promise.<Record.<string, (string|null)>>

# async resolveInternalId(objId) → {Promise.<string>}

Resolves the most appropriate internal ID for a given external object ID.

This method wraps desiteAPI.mapFromExternalIDs and applies additional resolution rules when multiple internal IDs are mapped to the same external ID.

Resolution logic:

  1. Map the external ID to internal IDs using desiteAPI.mapFromExternalIDs
  2. If no internal IDs are found, fall back to the original external ID
  3. If exactly one internal ID is found, return it
  4. If multiple internal IDs are found:
    • Prefer the first ID whose domain is NOT "building"
    • If all IDs belong to the "building" domain, fall back to the first ID

This guarantees that the function always returns a usable ID.

Parameters:
Name Type Description
objId string

External object ID to resolve
Since:
  • 2025-12-16 RM

View Source adapter/AdapterDesite_34_40.js, line 95

A promise resolving to the selected internal ID, or the original objId if no mapping could be resolved

Promise.<string>