company logo

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