im copycontent
copies nodes(s) to a new segment
Synopsis
im copycontent [--asOf=<date>:label:<label>] [--parentID=value] [--insertLocation[=number|first|last|before:name|after:name] [--[no]recurse] [--[no]confirmLarge] --threshold=value] [--[no]traces] [--refmode=[reuse|share] [--[no]branch] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] segmentID:nodeID|nodeID...
Description
im copycontent copies nodes to a new segment. You can insert the copied content at a specified location in the segment structure. For example:
im copycontent --parentID=23 --insertLocation=3 15 242 590
copies issues 15, 242 and 590 and inserts them at locations 3, 4 and 5 in the structural relationship list for segment 23.
Options
This command takes the universal options available to all
im commands, as well as some general options. See the
options reference page for descriptions.
• --asOf=<date>:label:<label>
allows you to copy content as of a specific date or label. For example, to copy content based on a specific date, type:
im copycontent --asOf="January 8, 2012 10:00:00 AM EST" 123
• --[no]recurse
indicates whether to copy all nodes and/or segments beneath the specify.
• --[no]confirmlarge
species to display a message to users confirming that they are copying a large number of content issues. The default is 50 and can be modified using the --threshold option.
• --[no]traces
indicates whether to copy all existing trace relationships to the new (copied) nodes. The default is
--notraces.Use
im propegatetraces to copy traces to the branched document.
• --[no]branch
indicates that the copy operation you are performing will be a branch. Branching creates a copy of the segment and adds it to the project history. You can branch a segment as of a specific date or label.
• --threshold=value
specifies the number of content issues to allow users to copy. The default threshold is 50. Users will be prompted to confirm a copy operation of more than 50 issues. If you increase the default threshold, you can specify --[no]confirmlarge option to either notify users or bypass notification.
• --parentID=value
the ID of the parent segment or node that will contain the reference to the node being copied. This option is required.
• --refmode=[reuse|share]
specifies the reference mode you want to apply to the copied content. See the Integrity Lifecycle Manager Help Center for details about reference modes and standard copy and paste operations or copy and paste for reuse.
• --insertLocation[=number|first|last|before:name|after:name]
determines where the copied content should go in the parent segment's structural relationship list. The options are as follows:
first inserts the content at the beginning of the list.
last inserts the content at the end of the list.
before:name inserts the content before the specified ID.
after:name inserts the content after the specified ID.
[0,...] inserts the content at the specified location. If a negative is specified, the content is inserted at the beginning of the list. If the number specified is too large, the content is inserted at the end of the list.
• segmentID:nodeID...
nodeID...
the ID of the node you want to copy. There are two forms of selection available: both the segment ID and the node ID, or just the node ID. To copy versioned content with the --recurse option, the selection must include both the segment ID and the node ID.
Use a space separated list to specify more than one node to copy. The following is an example of specifying the segment ID and node ID: 239:240 149:150 102:103. An example of specifying just the node ID is 240 150 103.
The following is an example of specifying versioned nodes: 239-1.1:240-1.1 239-2.2:240-2.2 239-3.3:240-3.3.
The following is an example of specifying a mix of formats: 239-1.1:240-1.1 550 331:332.
|
|
To restrict access to specific information in documents, all documents are subject to visibility rules set by your administrator. You must have visibility to the nodes you want to copy. For more information, contact your administrator.
|
See Also
