company logo

Move instance (MOV)

The command moves a single instance or a collection of instances from the current collection to the referenced collection. Moving an instance will remove the instance from the source collection and 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 moved
  • . - move instance currently selected in the collection
  • * - move all instances filtered in the current collection (--> sfc)
  • new_key - move and rename instance of an ordered collection (move single instance, only
  • -Dn - target data source for move. When no target is defined, the instance is moved to the current data source (e.g. rename)
  • -Cn - target collection for move. When no target collection is passed the instance is moved to the current collection in the referenced data source (-Dn)

Syntax:

  mov keyval|position|.|* [new_key] -Dn -Cn

Examples:

  mov Miller|Paul // Move person instance for Paul Miller to selected

                  // instance

  mov 0           // Move first instance to selected instance

  mov . -D3 -C2   // Move selected instance to collection 2 in data

                  // source 3