Copy instance (CPY)
The command copies a single instance or a collection of instances from the current collection to the referenced collection. Copying an instance will change the selections for all subsequent collections in the target hierarchy.
Parameters:
- key_value - key value for the instance to be copied (ordered collection). Key components have to be separated by '|'. When the key value contains special characters, it has to be quoted.
- position - position of instance to be copied
- . - cpoy instance currently selected in the collection
- * - copy all instances filtered in the current colletion (--> sfc)
- new_key - copy and rename instance of an ordered collection (copy single instance, only
- -Dn - target data source for copy. When no target is defined, the instance is copied to the current data source (e.g. rename)
- -Cn - target collection for copy. When no target collection is passed the instance is copied to the current collection in the referenced data source ( -Dn )
Syntax:
cpy keyval|position|.|* [new_key] -Dn -Cn
Examples
cpy Miller|Paul // Copy person instance for Paul Miller to selected
// instance
cpy 0 // Copy first instance to selected instance
cpy . -D3 -C2 // Copy selected instance to collection 2 in data
// source 3