company logo

COPY_Options - Copy types

Copy types are used for defining a copy strategy, i.e. the depth of the copy process. The exact meaning of copy types depends on the context where copy types are used.

Enumarators overview

Enumerator details

  1. COPY_model - Copy accoring to copy model

    The copy option causes copying or exporting instance data. References and relationships are copied according to copy rules defined in the data model.

    Code: 0
    to list
  2. COPY_local - Copy owning references

    The copy option causes copying or exporting instances for a reference or relationship owning the instances.

    Code: 1
    to list
  3. COPY_all - Copy all

    The value indicates, that instances and relationships are to be copied. Copy does perform a deep copy operation, i.e. owned instances and its relationships are copied as well. References to instances not owned by the copied instance are copied as references only, i.e. instance data for instances not owned by the instance is not copied, but links are created

    Deep copy operations allow copying the complete database content without redundancy and without the risk of infinite recursions. This is also the default setting for the copy level in the copy model when creating new data type properties.

    Code: 2
    to list

  4. COPY_deep - Deep copy

    The value indicates, that instances and relationships are to be copied. Copy does perform a deep copy operation, i.e. referenced instances and relationships are copied as well. Since this often leads to infinite recursion, CopyAll should be used in order to achieve save and optimal copy.

    Code: 3
    to list
  5. COPY_instance - Copy instances

    The value indicates, that only instance data is copied without copying referenced instances.

    Code: 4
    to list
  6. COPY_relationships - Copy relationships

    When passing this option as copy option, only links to related (not owning) instances will be copied. The function also copies relationships recursively, i.e. links in related instances owned by the instance are copied as well.

    Code: 5
    to list
  7. COPY_none - Do not copy referenced instances or attribute

    This copy option is used for suppress copy operations. Thus, it can be used in some cases for testing copy functions (e.g. for testing import files). It is also used for suppressing copy of attribute data

    Notes:

    This copy level can be used for renumbering __AUTOIDENT instances by setting copy level for __AUTOIDENT to none.

    Code: 6
    to list
  8. COPY_link - Copy links or key attributes

    The option is used for copying references to related data. It may apply on relationships in order to copy links or for exporting the primary or sort key rather than the complete instance. This allows maintaining links without overwriting existing instances.

    Code: 7
    to list