si viewcp
displays details for a Windchill RV&S configuration management change package
Synopsis
si viewcp [--fields=field1[:width1],field2[:width2]...] [--[no]showCommitted] [--[no]showUncommitted] [--[no]showPending] [--[no]showReviewLog] [--[no]showPropagationInfo] [--format=value] [--height=value] [--width=value] [-x value] [-y value] [--headerFormat=value] [--noFormat=value] [--noHeaderFormat=value] [--noTrailerFormat=value] [--trailerFormat=value] [--width=value] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [--quiet] [(-g|--gui)] [--settingsUI=[gui|default]] [--status=[none|gui|default]] issue|issue:change package id...
Description
si viewcp allows you to view details on any Windchill RV&S configuration management change package you select. For example:
si viewcp 2:23
You can select the change package using an issue ID or change package ID, and the change package does not have to be assigned to you.
Options
This command takes the universal options available to all
si commands, as well as some general options. See the
options reference page for descriptions.
• --fields=field1[:width1],field2[:width2]...
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. Fields are separated with a space.
The fields available for printing can be one or more of the following:
• bytesadded
displays the number of bytes added by the operation. For text files, this field displays 0.
• bytesdeleted
displays the number of bytes deleted by the operation. For text files, this field displays 0.
• closeddate
displays the date the change package was closed on.
• cptype
displays the change package type.
• configpath
displays the configuration path of the change package entry (repository location of the member/subproject).
• creationdate
displays date the change package was created..
• description
displays the description of the selected change package.
• haspropagated
displays 1 if the change package has propagated other change packages, 0 if not.
• haspropagatedby
displays 1 if the change package has been propagated by other change packages, 0 if not.
• hasreverted
displays 1 if the change package has reverted at least one other change package, 0 if not.
• hasrevertedby
displays 1 if the change package was reverted by at least one other change package, 0 if not.
• id
displays the ID of the issue associated with the selected change package.
• isclosed
indicates if the change package is closed.
• istext
indicates if the change package entry has a text archive.
• linesadded
displays the number of lines added by the operation. For binary files, this field displays 0.
• linesdeleted
displays the number of lines deleted by the operation. For binary files, this field displays 0.
• location
displays the archive location for members or the location of the parent project for subprojects.
• member
displays the name of the member or subproject affected by the operation.
• membertype
displays the type of project element affected by the operation (member or subproject).
• project
displays the name and path of the project where the operation was performed. If the operation occurred in a shared subproject, the subproject name and path are displayed. If the operation involved two different projects (for example, moving a member from one project to another), information for both projects is displayed.
• propagated
displays a list of the change packages that have been propagated by the selected change package.
• propagatedby
displays a list of the change packages that propagated the selected change package.
• reverted
displays the IDs of the change packages that were reverted by the change package being viewed.
• revertedby
displays the IDs of the change packages that reverted the change package being viewed.
• revision
displays the member revision number.
• sandbox
displays the name of the sandbox where the deferred operation or check out took place.
• server
displays the server the change package resides on.
• showpropagationinfo
displays the propagation information for the change package.
• siserver
displays the Windchill RV&S Server the change package resides on.
• state
displays the status of the change package.
• summary
displays the change package summary.
• timestamp
displays the timestamp of the selected change package.
• type
displays how the member was added to the change package.
• user
displays the ID of the user who added the member to the change package.
• variant
displays the names of variant projects associated with the member.
• --[no]showPropagationInfo
specifies whether to display a list of the change packages that have been propagated by or reverted by the selected change package, and a list of the change packages that propagated or reverted the selected change package.
• --[no]showCommitted
specifies whether to display committed operations. Committed operations appear as change package entries that contain changes committed to the server repository.
• --[no]showUncommitted
specifies whether to display uncommitted operations. Uncommitted operations are work in progress, lock or deferred entries that can be submitted to the server repository.
• --[no]showPending
specifies whether to display pending entries that have not yet committed to the repository.
• --[no]showReviewLog
specifies whether to display review information. Windchill RV&S provides review logs as part of a complete review audit process. A log consists of individual records for each reviewer vote cast. Each time the change package is submitted for review, a new log begins.
Each review record contains the following information:
Review States The possible review states are:
◦ Review Pending the change package is still in a state of Submitted and there are outstanding votes to be cast by reviewers.
◦ Accepted the change package is in a state of Accepted, and all of the individual reviewers and a user from each reviewer group have accepted the change package.
◦ Rejected the change package is in a state of Rejected, and at least one reviewer has rejected the change package.
Reviewer Type The possible reviewer types are:
◦ User Reviewer is a user voting in an individual capacity.
◦ Group Reviewer is a user voting in a group capacity on behalf of that group.
◦ Super Reviewer is a user casting an overriding vote in a super reviewer capacity, and is not required to be a user on the reviewer list or in a group on the group reviewer list.
Votes The possible vote values are:
◦ Pending signifies that the reviewer or group reviewer has not yet cast a vote.
◦ Accepted signifies that the user has cast an accept vote for the change package.
◦ Rejected signifies that the user has cast a reject vote for the change package.
Comments Displays information that reviewers optionally provide to clarify their votes.
Changes Displays in tabular form the changes that were made to upon submission of the change package.
si viewcp also includes options that deal with formatting for the view.
• --format=value
• defines an output format for user-formatted text. The default formatting is suitable for interpretation by most users; the various formatting options are provided for programmatic control.
This option and the --fields option are mutually exclusive.
--format options use the same values as --fields, but similar to a JAVA MessageFormat string (that is, it requires { } to surround each field). The --fields option automatically adds a newline on the end, but you must supply the newline for formats with a \n, for example:
si viewcp --format="{member},{revision}\n"
• --headerFormat=value
header for user-formatted text (see --format).
• --noFormat=value
format for user-formatted text (see --format).
• --noHeaderFormat=value
header for user-formatted text (see --format).
• --noTrailerFormat=value
trailer for user-formatted text (see --format).
• --trailerFormat=value
trailer for user-formatted text (see --format).
• issue...
• issue:change package id...
issue identifies a specific issue that contains all change packages that you want to view; use spaces to specify more than one issue.
issue:change package id identifies a specific change package to view; use spaces to specify more than one change package.
Diagnostics
See the
diagnostics reference page for possible exit status values.
Preferences
Using
si setprefs or
si viewprefs, you are able to set or view the preference keys for this command.
See Also