Syntax and Attributes

Syntax

<dimensions>

   <run>

   <getCopy>

   <export>

where:

<dimensions>

Provides access to Dimensions CM command-line functionality.

Attribute

Description

Required?

userID        

Dimensions user ID to connect as.   

 Yes          

password      

Password for the user ID.           

 Yes          

database      

Dimensions base database to connect to in the format NAME@CONNECTION.

 Yes          

server        

Dimensions server hostname with optional port number, for example, ord-dm:672.

 Yes          

<run>

Runs a Dimensions command-line.

Attribute

Description

Required?

cmd           

 Dimensions command-line to run.     

 Yes          

<getCopy>

Uses the FI command to fetch item revisions from a project to a local working location. This command is now deprecated and to improve performance you should use the <run> element with a DOWNLOAD command-line.

Attribute

Description

Required?

srcProject    

The source project to fetch from.       

 Yes          

srcPath       

The source project folder.              

 Yes          

destPath      

The destination working location.       

 Yes          

expand        

Uses the /EXPAND qualifier on the FI command.    

 No (false)   

recursive     

Fetches items recursively from the child project folders.

 No (false)   

<export>

Uses the AIWS command to export revisions from one project to another. This command is now deprecated and you should use the <run> element with an AIWS command-line.

Attribute

Description

Required?

srcProject    

The source project to export from.      

 Yes          

srcPath       

The source project folder.              

 Yes          

destProject   

The destination project to export into.

 Yes          

allRevisions  

Includes all revisions (not just the tip revisions).

 No (false)

recursive     

Exports items recursively from child project folders.

 No (false)