im projects
displays the list of projects
Synopsis
im projects [--fields=field1[:width1],field2[:width2]...] [--fieldsDelim=value] [--height=value] [--width=value] [-x value] [-y value] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--[no]asAdmin] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] project...
Description
im projects displays a list of projects for workflows and documents. By default, all projects are selected to be displayed.
 |
If you are a project administrator, only the projects that you are assigned to display, allowing you to specify, edit, and view only those projects. If you have additional permissions that allow you to view projects you are not assigned to, such as Admin or CreateProject, those projects also display.
|
Options
This command takes the universal options available to allim commands, as well as some general options. See the options reference page for descriptions.
• --fields=field1[:width1],field2[:width2]...
where fieldn can be any of the following:
◦ name
displays the name of the project. By default, only the name is shown.
◦ id
displays the database ID of the project. This is for PTC Technical Support only.
◦ description
displays a description of the project.
◦ parent
displays if there is a parent that exists for the project.
◦ permittedGroups
displays the groups that have visibility or inheritance for the project.
◦ isActive
displays the active status of the project.
◦ openImage
displays if there is an image icon file used for an open project when it is displayed in the graphical user interface, and if the image is custom or default.
◦ permittedAdministrators
displays the users and groups who have been granted access to administer the project.
◦ backingIssueID
displays the backing issue ID for the project, if specified.
◦ closedImage
displays if there is an image icon file used for a closed project when it is displayed in the graphical user interface and if the image is custom or default.
◦ references
displays a list of object references.
• --[no]asAdmin
allows non-admin access to projects. This option is used for third party integrations using the PTC RV&S API. The default setting is --asAdmin which requires ViewAdmin permissions. Specifying --noasAdmin allows users visability to permitted projects only. If a user selects a project without the applicable permissions they will receive an error indicating that the project was not found.
To learn more about the API, see your PTC RV&S Integrations Builder Guide.
• --fieldsDelim=value
specifies the string to be used as a delimiter between fields displayed in the CLI.
• project...
specifies the names of the projects to view.
See Also
• Miscellaneous: options