im runchart
runs an Integrity Lifecycle Manager chart
Synopsis
im runchart [--fieldFilter=field=[value,value,...]] [--graphStyle=[VerticalBar|VerticalStackedBar|HorizontalBar|HorizontalStackedBar|Pie|Line|Table|XY|Bubble]] [--chartFootnote=value] [--chartTitle=value] [--description=value] [--[no]displayDescription=value] [--imageHeight=value] [--imageWidth=value] [--outputFile=value] [--[no|confirm]overwriteOutputFile] [--query=[user:]query] [--queryDefinition=query] [--hostname=value] [--port=value] [--password=value] [--user=value] [(-?|--usage)] [(-F value|--selectionFile=value)] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]] [user:]chart
Description
im runchart runs an Integrity Lifecycle Manager chart, generating chart data. For more information on charts, refer to the Integrity Lifecycle Manager Help Center.
For example,
im runchart --gui jriley:"Release 2 Features By Priority"
displays the Release 2 Features By Priority chart created by jriley.
Note the following:
• All charts are subject to visibility rules set by your administrator. Visibility rules restrict access to specific information based on project and/or issue type. For more information, see the Integrity Lifecycle Manager Help Center, or see your administrator.
• For the best performance, avoid generating trend or issue fields trend charts using short intervals over long time spans.
• Displayed date fields do not change based on the time zone that a user is operating in; however, displayed date/time fields and time entries vary based on the time zone that a user is operating in.
Options
This command takes the universal options available to
im commands, as well as some general options. See the
options reference page for descriptions.
• --fieldFilter=field=[value,value,...]
specifies project filter values to apply to the chart.
|
|
If you are running a distribution chart that is based on a query with a project filter, the project filter values you specify here are combined with the query filter. In some cases, this could result in no data being returned. For example, if a chart is based on a query with an embedded project filter value of Cosmo1, and you specify a project filter value of Cosmo2, no data is returned.
|
• --graphStyle=[VerticalBar|VerticalStackedBar|HorizontalBar|HorizontalStackedBar|Pie|Line|Table|XY|Bubble]
overrides the graph style defined for the chart.
• --chartFootnote=value
Overrides the chart footnote with the specified value.
• --chartTitle=value
Overrides the chart title with the specified value.
• --description=value
Overrides the chart description with the specified value.
• --[no]displayDescription=value
Overrides the chart display description with the specified value. When you specify --nodisplayDescription, the chart description is not displayed.
--imageHeight=value
specifies the height of the image, in pixels; value must be a whole number. This option does not apply to table style charts.
• --imageWidth=value
specifies the width of the image, in pixels; value must be a whole number. This option does not apply to table style charts.
• --outputFile=value
specifies the name of the file you want the chart data to be saved in.
|
|
Table style charts are saved in comma separated values (csv) format. All other styles of charts are saved in PNG format.
|
• --[no|confirm]overwriteOutputFile
specifies whether to overwrite if the file specified in the --outputFile option already exists.
• --query=[user:]query
specifies a query to override the chart query.
• --queryDefinition=query
specifies a string to define the query constraints to override the chart query. For details of the query format, see the
im createquery reference page.
|
|
To reference the original query in the new query so that any changes to the original query are reflected in the new query, define <subquery> as subquery[OriginalQuery]
|
• [user:]chart
specifies the name of the chart to run, and the user who created it. If you are running a chart you created, you do not have to specify the user name, but you must specify the chart name.
|
|
Integrity Lifecycle Manager initially assumes that text before the colon (:) is a user name and text after it is a chart name. If Integrity Lifecycle Manager fails to find a matching user name and chart name, it searches for a chart name matching the exact text. For example, if you type jhoyt:CosmosDefects, Integrity Lifecycle Manager searches for the CosmosDefects chart created by jhoyt. If Integrity Lifecycle Manager cannot find the chart and/or user, it searches for the jhoyt:CosmosDefects chart created by any user.
|
See Also
