CLI Reference > Workflows and Documents Commands > im charts
 
im charts
displays a list of charts
Synopsis
im charts[--fields=field1[:width1],field2[:width2]...][--fieldsDelim=value][--[no]showHistory][--[no]showReferences][--height=value][--width=value][-x value][-yvalue ][--user=value] [-- hostname=value ] [--password=value][--port=value][(-?|--usage)] [(-g|--gui)] [(-F value |--selectionFile= value )] [--quiet] [--settingsUI=[ gui |default ]] [--status=[ none | gui | default ]] [(-N|--no)][(-Y|--yes)] [--[no]batch] [--cwd= value ] [--forceConfirm=[yes | no]] chart...
Description
im charts displays a list of Integrity Lifecycle Manager charts. By default, the command displays all charts that are currently shared with you.
Options
This command takes the universal options available to im commands, as well as some general options. See the options reference page for descriptions.
--fields=field1[:width1],field2[:width2]...
specifies the chart fields to display and the width of each field in characters. If the output is directed to the GUI, the width is specified in pixels.
For example,
im charts --fields=name,chartType,createdBy --fieldsDelim=, "Defect Analysis By Project"
displays the name, chart type and creator for the Defect Analysis By Project chart, with each field separated by a comma.
The chart fields you can specify are:
chartType
displays the type of chart.
createdBy displays the name of the user who created the chart.
description
displays a description of the chart.
graphStyle
displays the style of graph used for the chart.
lastModified
displays the date the chart was last modified.
name
displays the name of the chart.
query
displays the name of the query the chart is based on.
shareWith
displays the users and groups that the chart is shared with.
sharedGroups
displays the groups that the chart is shared with.
id
displays the database ID of the chart. This is for PTC Technical Support only.
references
displays all system provided and user objects that reference the chart.
isAdmin
displays whether the chart is a system provided object.
--fieldsDelim=value
specifies the string to be used as a delimiter between fields.
--[no]showHistory
specifies whether to display a read-only log of all changes to the chart.
--[no]showReferences
specifies whether to display all system provided and user objects that reference the chart.
chart
identifies the names of the charts to view.
See Also
Commands: im copychart, im createchart, im deletechart, im editchart, im viewchart, im runchart
Miscellaneous:options