im copyreport
copies the properties of an existing report to create a new report
Synopsis
im copyreport[--query=[user:]query] [--reportTemplate=value] [--reportTemplateFile=value] [--shareWith=u=user1[:modify],user2[:modify],...;g=group1[:modify],group2[:modify],...] [--name=value] [--description=value] [--sharedAdmin][--hostname= value] [--port=value] [--password=value] [--user=value] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]][user:]report
Description
im copyreport copies the properties of an Integrity Lifecycle Manager report to a new Integrity Lifecycle Manager report. For more information on reports, refer to the Integrity Lifecycle Manager Help Center.
For example,
im copyreport --query=mchang:"Docs Items Worked On This Week" --name="Docs Weekly Status" jriley:"Docs Daily Status"
copies the Docs Daily Status report created by jriley to a new report called Docs Weekly Status, based on a query created by mchang.
Note the following:
• Reports can do more than just display field information. You can also perform arithmetic calculations between numeric fields, displaying the values in the report. For example, you can add up column totals or count the number of issues in a specific state. To perform these calculations, you create a computed expression. For more information on the syntax, operators, functions, and operations applicable to computed expressions, see your administrator or the Integrity Lifecycle Manager Help Center.
• A report can be edited by the user who created it. Principals (users and groups) that a report is shared to can edit it if they have edit permissions assigned to them by the report creator. A report can only be deleted by the user who created it or by the administrator.
• Because reports are based on queries, reports are subject to visibility rules set by your administrator. Visibility rules restrict access to specific information based on project or issue type. For more information, see the Integrity Lifecycle Manager Help Center, or contact your administrator.
• Symbolic dates in rules and queries are evaluated on the Integrity Lifecycle Manager Client’s time zone.
• Relevance and editability rules are evaluated on the Integrity Lifecycle Manager Client’s time zone.
• Creating deeply nested reports with a large number of inter-related issues can create extremely large reports or cause the Integrity Lifecycle Manager Server to stop responding. When creating a report, take into consideration that the average number of links per issue and the number of levels in the report multiply the size of the report.
• Computed expressions return dates/times in the Integrity Lifecycle Manager Client’s time zone and perform calculations in the Integrity Lifecycle Manager Server’s time zone where appropriate.
• Although the electronic signature fields Signed By and Signature Comment are only visible in an issue’s history (if enabled by your administrator), you can report on the historical values by specifying the fields in the report.
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.
• --query=[user:]query
specifies the name of the query that defines the selection criteria for the report, and the user who created the query.
• --reportTemplate-value
specifies the report template on which the report is based.
For information on the report template format, see the Integrity Lifecycle Manager Help Center.
• --reportTemplateFile=value
specifies the file name that contains a report template. For information on the report template file format, see the Integrity Lifecycle Manager Help Center.
• --shareWith=u=user1[:modify],user2[:modify],...;g=group1[:modify],group2[:modify],...
specifies the users and groups that can use and modify the report. Your administrator defines users and groups.
• --name=value
specifies the name of the report.
|
|
Note: If you do not specify a different name for the new report, Integrity Lifecycle Manager adds Copy of as a prefix to the query name, for example, Copy of Cosmos Critical Defects.
|
• --description=value
specifies a description for the report.
• --sharedAdmin
specifies the report as a system provided object (objects within the Integrity Lifecycle Manager object model that support solution definition and management, as well as workflow migration). For more information, see your administrator.
Important:
Once a user object is converted to a system provided object, you cannot revert it to a user object again.
|
|
If the report you are copying is an admin report, the --sharedAdmin option is not set in the copy.
|
• [username:]report
specifies the name of the report to copy, and the user who created that report. This is useful when multiple users have the same name for a report.
|
|
Integrity Lifecycle Manager initially assumes that text before the colon (:) is a user name and text after it is a report name. If Integrity Lifecycle Manager fails to find a matching user name and report name, it searches for a report name matching the exact text. For example, if you type jhoyt:CosmosDefects, Integrity Lifecycle Manager searches for the CosmosDefects report created by jhoyt. If Integrity Lifecycle Manager cannot find the report and user, it searches for the jhoyt:CosmosDefects report created by any user.
|
See Also
