Document number	Revision
DOCU12263	1

Clone - Configuration

Clone - ConfigurationBackgroundAccess and SecurityClone variationsConfigurationDefault configurationAvailable Clone configurationsChanging which properties are copiedAdvanced configurationClone variations for different basetypes

Background

Clone can be configured in a number of ways to support different variations of how items are cloned. The configuration has an influence on which properties, references and files that are copied from the existing items to the new item.

Access and Security

By default, Clone capabilities is available to users with user level AdvancedUser,SuperUser, AdminRead,AdminWrite.

Users can access the Clone features by navigating to Options>Advanced from any item (Document, Action, Part, Device):

properties

Clone variations

There are two distinct Clone buttons that can be enabled in Highstage; CLONE and CLONE From New.

Clone allows you to to copy the item including:
- Properties
- References
- Files (Existing files from the item)
CLONE From New allows you to copy the item including:
- Properties
- References
- New template files (Clears the folder and inserts template files from the appropriate item subtype)

Configuration

Default configuration

By default, CLONE is available on all items.

This is achieved through the following snippet:


xxxxxxxxxx
    <type name="ts_item">
        <feature name="config-manager" clone="1" />
    </type>

Available Clone configurations

The clone property associated with the <feature> element can be set to a specific value (0 / 1 / 2 / 3) determining the availability of Clone and/or CLONE From New:

No clone available


xxxxxxxxxx
<feature name="config-manager" clone="0" />

Setting Clone="0" makes CLONE and CLONE From New unavailable.

Make CLONE available


xxxxxxxxxx
<feature name="config-manager" clone="1" />

Setting clone="1" makes CLONE available.

Make CLONE From New available


xxxxxxxxxx
<feature name="config-manager" clone="2" />

Setting clone="2" makes CLONE From New.

Make CLONE AND CLONE From New available


xxxxxxxxxx
<feature name="config-manager" clone="3" />

Setting clone="3" makes CLONE AND CLONE From New available.

Changing which properties are copied

You can configure which properties is copied over to the new item when cloning an existing item. By default, only a select number of properties is copied over.

Tip!
To get an overview of which current columns (properties) are copied to new items when cloning, navigate to SYSTEM>DIAGNOSTIC>Master Schema. From here you can search (CLTR+F) for clone to see whether they are copied over (clone="1") or ignored (clone="0") for each separate <column> element.

To determine whether a specific column (property) should be copied over to the new item when cloning, you can change the clone="0 / 1" property on the specific <column> element.

For instance, the following snippet ensures that Clone also copies the Alias and Description columns:

properties


x
  <column name="alias" clone="1" />
  <column name="description" clone="1" />

Advanced configuration

Clone variations for different basetypes

You can have different Clone settings and associated properties that are copied when cloning for each separate basetype in Highstage.

For instance, the following example includes both CLONE and CLONE From New on Documents but makes only Clone available for Actions. Similarly, we omit the Alias property for Documents from being cloned to new items but includes Alias for Actions:


xxxxxxxxxx
    <type name="doc">
        <column name="alias" clone="0" />
        <feature name="config-manager" clone="3" />
    </type>
  <type name="action">
        <column name="alias" clone="1" />
        <feature name="config-manager" clone="0" />
  </type>

highstage_footer