Show TOC

GETLocate this document in the navigation structure

Use

Synchronizes a versioned object or objects on the local file system with a state of this object on the server. Most often this means copying the current active object version from the server to the local file system. Besides that, the get command also allows synchronization with a version of the object that is currently not active but was active once in the past. The get command accepts both file and folder URLs. In case of a file URL, only this file is synchronized. In case of a folder URL, all members of the folder, up to infinite depth, are synchronized.

Syntax

Syntax

GET [ folderItemPath ] [[@BranchSequenceNum] | [#RevisionNum] | [-ts "yyyy-mm-dd hh:mm:ss"] | [-f|-p]] [-a] [-w "workspacePath" ]

Arguments

[-f]

If specified, the given folder item is synchronized to the latest even if it has already been synchronized or is writable

[-p]

If specified, the given folder item is not synchronized, only a preview of what will be synchronized is displayed.

[-ts "yyyy-mm-dd hh:mm:ss"]

If specified, the given folder item is synchronized to the state at the given timestamp. The format of the timestamp is yyyy-mm-dd hh:mm:ss .

[-a]

If specified, the versions which are present in the given activity are synchronized.

[-w "workspacePath" ]

Workspace path to specify the workspace under which the activity exists. Specify this if activity name is specified. If it is not specified, the current directory is used to resolve the workspace. Versions are synchronized with this workspace.

[@BranchSequenceNum]

Branch sequence number. You can specify the branch with branch sequence number to be synchronized by suffixing the path with a number sign ( # ) character followed by the Branch sequence number. If no BranchSequenceNum or RevisionNum is specified, then the contents of the latest version of this file on the server are synchronized.

[#RevisionNum]

Revision number. The revision with revision number to be synchronized can be specified by suffixing the path by a number sign ( # ) character followed by the branch sequence number required.

Description

Synchronizes the folder item on the local file system with the view on the server. Takes the path (local or remote) as an argument. Wild characters are accepted.

Note that all the parameters cannot be specified together, that is, you can specify only one of:

  • timestamp

  • branch sequence number

  • revision number

  • force or preview

    If force and preview are specified together then the command is not executed.

    If the others are specified together then the order of priority will be the order in which the options have been listed.

Example

get xyz -ts "200 7 -06-01 18:32:77"

Another use of -ts is in conjugation with -a/-w options.

get -a <act name> -w <ws path> -ts NOW

Here the latest versions of the files who have versions present in this activity will be synchronized with the client in the given workspace.

Example

Synchronizing the Content of a Workspace

To synchronize the complete content of the workspace //path/to/wsp , execute:

get //path/to/wsp

Synchronizing the Content of a Folder

To synchronize a folder and its content, specify the path to this folder, for example:

get //path/to/wsp/myproject/src

Synchronizing the Versions Created in a Specific Activity

If activity a1 was checked into workspace //test/dev and you want to synchronize exactly the versions created by this activity, execute:

get //test/dev -a a1