CLI Reference > Workflows and Documents Commands > im copyreport
im copyreport
copies the properties of an existing report to create a new report
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
im copyreport copies the properties of a Windchill RV&S report to a new Windchill RV&S report. For more information on reports, refer to the Windchill RV&S 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 Windchill RV&S 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 Windchill RV&S Help Center, or contact your administrator.
Symbolic dates in rules and queries are evaluated on the Windchill RV&S Client’s time zone.
Relevance and editability rules are evaluated on the Windchill RV&S Client’s time zone.
Creating deeply nested reports with a large number of inter-related issues can create extremely large reports or cause the Windchill RV&S 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 Windchill RV&S Client’s time zone and perform calculations in the Windchill RV&S 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.
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
specifies the name of the query that defines the selection criteria for the report, and the user who created the query.
specifies the report template on which the report is based.
For information on the report template format, see the Windchill RV&S Help Center.
specifies the file name that contains a report template. For information on the report template file format, see the Windchill RV&S Help Center.
specifies the users and groups that can use and modify the report. Your administrator defines users and groups.
specifies the name of the report.
Note: If you do not specify a different name for the new report, Windchill RV&S adds Copy of as a prefix to the query name, for example, Copy of Cosmos Critical Defects.
specifies a description for the report.
specifies the report as a system provided object (objects within the Windchill RV&S object model that support solution definition and management, as well as workflow migration). For more information, see your administrator.
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.
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.
Windchill RV&S initially assumes that text before the colon (:) is a user name and text after it is a report name. If Windchill RV&S 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, Windchill RV&S searches for the CosmosDefects report created by jhoyt. If Windchill RV&S cannot find the report and user, it searches for the jhoyt:CosmosDefects report created by any user.
See Also
Commands: im createreport, im editreport, im viewreport, im runreport, im deletereport, im reports
Miscellaneous: options