|
Windchill RV&S client URL links are supported on all Windows platforms supported by the Windchill RV&S client. For the most current product platform support information, see Windchill RV&S Supported Platforms.
|
|
By default, e-mail notifications generated by the Windchill RV&S client and Windchill RV&S server include Windchill RV&S client URLs, which are controlled in the Windchill RV&S administration client by the mksis.includeIntegrityGUILinks property. For more information, see the topic on e-mail notifications or contact your administrator.
|
|
The hostname may be determined based on values defined by your administrator.
|
|
Encoding is required for the values of the command options. For more information, see “URL Encoding Requirements and Considerations”.
|
|
Depending on your e-mail application, the Windchill RV&S client URL link may not be active or clickable until the recipient receives the e-mail notification.
|
|
Time is specified from 00:00:00 to 23:59:59 inclusive in 24-hour format, for example, a URL that refers to a time of 13:56:45 is the same as 1:56:45 PM.
In addition, time is specified based on the local time of the sender. If the recipient is in a different time zone from the sender, when the link is clicked and the item opens, it displays in the local time zone.
|
|
Item revision information is not included in the client-generated e-mail when you click from a link in the item history, or if you are working from an item where the first revision has not been set.
|
Windchill RV&S client GUI View
|
CLI Command/Supported Options
|
URL Examples
|
||
Items view
|
im issues--query--queryDefinition--fields--sortField--sortAscending--nosortAscending
|
To open item in Windchill RV&S client GUI in Items view:
integrity://localhost:9001/im/issues?query=MyQuery&fields=Summary%2cPriority&sortField=Priority&sortAscending
|
||
Item Detail view
|
im viewissue--asof
|
To open item inWindchill RV&S client GUI in Item Detail view:
integrity://localhost:9001/im/viewissue? selection=1234
To open item in Windchill RV&S client GUI in historic Item Detail view:
integrity://localhost:9001/im/viewissue?selection=1234&asOf=20120730T190323Z
|
||
Document view
|
im viewsegment--asof--fields--outlineColumns
|
To open document in Windchill RV&S client GUI in Document view:
integrity://localhost:9001/im/viewsegment?selection=1234&fields=Category%2cText
|
||
Relationships view
|
im relationships--asof--fields
|
To open document in Windchill RV&S client GUI in Relationships view:
integrity://localhost:9001/im/relationships?selection=1234&fields=ID%2cType%2cState%2cSummary
|
||
Source Trace Viewer
|
im viewsourcetraces--project--asof--devpath--scmHost--scmPort--fields--projectrevision--revision--sortField--sortAscending--nosortAscending
|
To open Source Trace Viewer for member in normal project/subproject:
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3a%2fproject.pj& revision=1.0
To open Source Trace Viewer for member in variant subproject:
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3A%2Fproject.pj&devpath=TestDevPath&revision=1.0
or
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=%23c%3A%2F%23d%3DTestDevPath&revision=1.0
To open Source Trace Viewer for member in build project/subproject:
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3A%2Fproject.pj&projectrevision=1.0&revision=1.0
or
integrity://localhost:9001/si/viewsourcetraces?selection=code.java&project=%23c%3A%2F%23b%3D1.0&revision=1.0
|
||
Source Project
|
si viewproject--project--devpath--projectrevision--filtersubs--nofiltersubs
|
To open Windchill RV&S client GUI in Source Project view with empty subprojects filtered out:
integrity://localhost:9001/si/viewproject?project=%2FTestProject%2Fproject.pj&filtersubs
|
||
Source Member History
|
si viewhistory--project--devpath--projectrevision
|
To open Windchill RV&S client GUI in Source Member History view:
integrity://localhost:9001/si/viewhistory?selection=source.java&project=%2FTestProject%2Fproject.pj
|
||
Change Package
|
si viewcp
|
To open Windchill RV&S client GUI in Change Package view:
integrity://localhost:9001/si/viewcp?selection=1234%3A1
|
||
Dashboard
|
im rundashboard--fieldFilter
|
To open Windchill RV&S client GUI and run a specified dashboard:
integrity://localhost:9001/im/rundashboard?selection=%22My%20Dashboard%22
|
||
Report
|
im runreport--fieldFilter--asOf--issues--query--param--[no]substituteParams
|
To open Windchill RV&S client GUI and run a specified report:
integrity://localhost:9001/im/runreport?selection=%22My%20Report%22
|
|
For more information on ViewSets, see “Understanding ViewSets (GUI)”.
|
Character Types
|
Coding Requirements/Considerations
|
ASCII Control Characters
|
All characters within the range 00-1F and 7F must be encoded.
|
Reserved Characters
|
The following special characters are reserved:
• dollar sign ($) encode %24
• ampersand (\&) encode %26
• plus sign (+) encode %2B
• comma (,) encode %2C
• forward slash mark (/) encode %2F
• colon (:) encode %3A
• semi-colon (\;) encode %3B
• equal sign (=) encode %3D
• question mark (?) encode %3F
• at sign (@) encode %40
|
Unsafe Characters
|
Some special characters present the possibility of being misunderstood within URLs, for example, they could be incompatible or unreliable. PTC recommends encoding the following characters:
• blank space ( ) encode %20 (especially multiple spaces)
• quotation marks (“”) encode %22
• less than sign (\<) encode %3C
• greater than sign (\>) encode %3E
• number sign (#) encode %23
• percent (%) encode %25
• left brace ({) encode %7B
• right brace (}) encode %7D
• vertical bar/pipe (|) encode %7C
• backslash (\) encode %5C
• caret (^) encode %5E
• tilde (~) encode %7E
• left bracket ([) encode %5B
• right bracket (]) encode %5D
• grave accent (`) encode %60
|
Non-ASCII Characters
|
All non-ASCII characters must be encoded. This includes the entire top half of the ISO-Latin set 80-FF hexadecimal.
|
Unicode Characters
|
All unicode characters must be encoded. This includes everything above FF.
|