CLI Reference > Configuration Management Commands > si viewproject
si viewproject
displays the contents of a project
si viewproject [--fields=field1[:width1],field2[:width2]...] [--[no]filterSubs] [--height=value] [--width=value] [-x value] [-y value] [(-R|--[no|confirm]recurse)] [--filter=filteroptions] [(-P project|--project=project)] [--[no]failOnAmbiguousProject] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--projectRevision=rev] [--lockRecordFormat=value] [(-F file|--selectionFile=file)] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd =directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--[no]persist] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] member/subproject...
si viewproject displays the contents of a project and some information about the members, for example:
si viewproject c:/Aurora_Program/bin/Libra/project.pj
connect.txt 1.4 archived
source.txt 1.3 archived
config.c 1.3 archived
Specifying si viewproject -S sandbox does not view the Sandbox; it redirects through the Sandbox to view the project. Use si viewsandbox to view a Sandbox.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
allows you to select fields to be printed, specified in the format field1[:width1],field2[:width2].... Specifying the column [:width] (in pixels) for each field is optional. Widths are only available with the -g or --gui options. Under the CLI the fields are separated with a space.
The fields available for printing can be one or more of the following:
displays indicators for members that share another member’s archive. This column is valid only if you are using the database repository.
displays member attributes.
displays members that have changed since the project was last checkpointed. This field displays members that have changed due to operations that caused a change in member revision. These operations include Add Member, Rename Member, Move Member, Update Member Revision, and so on.
When used with the Windchill RV&S API, displays the name of the project, and indicates if the project is a build or variant.
This field is not valid for use with the CLI.
displays the change package associated with the operation that set the member revision.
displays the change package that created the revision that is currently the member revision. This revision may be different from the Member CPID if an import, add member from archive, or set member revision operation was used.
displays indicators for frozen members.
indents a field. For example:
si viewproject --fields=ident, name, type, memberrev
indents the name field, followed by type and memberrev fields, indenting as you recurse into subprojects.
This field is not valid for use with the Windchill RV&S API.
displays labels assigned to the member revision. Also displays checkpoint labels on a subproject configured as build. Multiple labels on the same checkpoint are displayed as a comma-separated list.
a comma separated list of locks on the member. The locker and lock type are displayed by default for each lock. You can customize the lock information that displays by using the --lockRecordFormat option.
displays the name and path of the member archive.
displays the member description.
displays the member revision.
displays the member timestamp.
displays the member name.
displays indicators for new revisions.
displays the change package associated with a pending operation.
displays the member state.
specifies whether the member is a symbolic link file member.
displays the type of each item in the project: project, subproject, shared-subproject, shared-variant-subproject, shared-build-subproject, or member.
controls whether to filter empty subprojects or subsandboxes from the view.
controls whether this presentation of information should continue to be updated as new information becomes available. --nopersist forces a static "snapshot" of information, while --persist gives real-time updates.
defines the format for displaying lock information in the --lockrecord field. Specify a format string using keywords to represent the information you want to display. You can specify any of the following keywords:
displays the revision that is locked.
displays the user who locked the revision.
displays the type of lock on the revision (exclusive or non-exclusive).
displays the time when the revision was locked.
displays the change package associated with the lock on the revision.
displays the name and path of the project where the member revision was locked from. If the member revision was locked from a shared subproject, it is the subproject name and path that are displayed.
displays the name of the development path where the lock on the revision was made from.
displays the name of the Sandbox where the lock on the revision was made. This is relevant when viewing the information from the locker host.
displays the hostname of the computer that locked the the revision.
displays 1 if the lock has a change package associated with it, 0 if there is no associated change package.
displays 1 if there is Sandbox information available for the lock, 0 if no Sandbox information is available.
displays 1 if the lock was made from a development path, 0 if it wasn't.
displays the name of the locked revision.
identifies a specific member or subproject; use spaces to specify more than one. The project context cannot be specified in the selection (use the -P or --project option if the project context is required).
See the diagnostics reference page for possible exit status values.
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si archiveinfo, si memberinfo, si mods, si print, si revisioninfo, si rlog, si sandboxinfo, si viewhistory, si viewlabels, si viewprojecthistory, si viewsandbox
Miscellaneous: ACL, diagnostics, options, preferences