URL-Links des PTC RV&S Clients
Sie können URL-Links des PTC RV&S Clients in clientgenerierten E-Mail-Benachrichtigungen senden, sodass Empfänger auf die Links klicken und die zugeordneten Elemente in verschiedenen GUI-Ansichten des PTC RV&S Clients öffnen können. Sie können die URL-Links auch in Berichte einschließen und über andere URL-Adressen wie Webseiten, Internet Explorer und das Windows-Menü > starten.
 |
URL-Links des PTC RV&S Clients werden auf allen Windows-Plattformen unterstützt, die vom PTC RV&S Client unterstützt werden. Die aktuellsten Unterstützungsinformationen für Produktplattformen finden Sie auf der Website PTC Versionsberater.
|
Wichtige Hinweise
• PTC RV&S Client URLs enthalten den Protokollnamen integrity://, der beim Windows-Betriebssystem auf jedem Client-Rechner registriert sein muss. Die Registrierung erfolgt automatisch, wenn Sie den PTC RV&S Client installieren.
Wenn mehrere Installationen des PTC RV&S Clients auf einem Rechner installiert sind, wird das Protokoll standardmäßig beim letzten installierten Client registriert und zum Öffnen von PTC RV&S Client URLs verwendet. Sie können das Protokoll bei einem anderen Client auf demselben Rechner registrieren (oder die Option deaktivieren). Schalten Sie dazu im Fensterbereich Allgemein des Client-Dialogfensters Einstellungskonfiguration die Option Dieser PTC RV&S Client antwortet auf PTC RV&S URL-Links. um. Weitere Informationen finden Sie unter Allgemeine Einstellungen.
|
|
Von PTC RV&S Client und PTC RV&S Server generierte E-Mail-Benachrichtigungen enthalten standardmäßig PTC RV&S Client URLs, die im PTC RV&S Administration Client durch die Eigenschaft mksis.includeIntegrityGUILinks gesteuert werden. Weitere Informationen finden Sie im Thema zu E-Mail-Benachrichtigungen oder wenden Sie sich an Ihren Administrator.
|
• PTC RV&S Client URLs verwenden ein benutzerdefiniertes Protokoll, das von Microsoft Outlook nicht erkannt wird. Deshalb werden jedes Mal, wenn Sie auf einen URL-Link des PTC RV&S Clients klicken, die Standardeingabeaufforderungen der Microsoft Office Outlook-Sicherheitswarnung angezeigt, in denen Sie gefragt werden, ob Sie fortfahren möchten. Klicken Sie im Dialogfenster auf Ja, um die PTC RV&S Client URL aufzurufen. Alternativ können Sie das Dialogfenster für das Protokoll integrity:// vollständig deaktivieren, indem Sie einen Registrierungseintrag im Betriebssystem erstellen. Weitere Informationen dazu finden Sie im Artikel CS121955 im PTC eSupport Portal.
• Für die Verwendung von PTC RV&S Client URLs in Rich-Text-Feldern muss das URL-Präfix integrity zur Eigenschaft mksis.im.validURLPrefixes auf dem PTC RV&S Server hinzugefügt werden.
• Wenn Sie ein Client Service Pack installieren, wird das PTC RV&S Protokoll nur automatisch installiert, wenn es derzeit nicht bei dem Client registriert ist. Wenn Sie das Protokoll für einen Client deaktivieren und später ein Service Pack auf denselben Client anwenden, wird das Protokoll möglicherweise auf dem Client erneut aktiviert.
• Das PTC RV&S Protokoll wird automatisch deinstalliert, und seine Registrierungseinträge werden entfernt, wenn Sie den PTC RV&S Client deinstallieren. Wenn das Protokoll jedoch bei einem anderen Client registriert ist (im Falle mehrerer Clients auf einem einzelnen Rechner), werden die Registrierungseinträge nicht entfernt.
URL-Syntax des PTC RV&S Clients
Die Syntax der PTC RV&S Client URL ist wie folgt:
integrity://<server>:<port>/<app>/<command>?selection=<id>
&<option1>=<value1>&<option2>=<value2>
Dabei gilt:
• integrity:// ist das PTC RV&S URL-Protokoll, das bei Windows registriert ist
• server ist der Hostname des Rechners, auf dem der PTC RV&S Server installiert ist
|
|
Der Hostname kann basierend auf von Ihrem Administrator definierten Werten bestimmt werden.
|
• port ist die Portnummer des Rechners, auf dem der PTC RV&S Server installiert ist
• app ist die Abkürzung für die domänenspezifische PTC RV&S Anwendung, z.B. im=Workflows und Dokumente, si=Konfigurationsverwaltung, extended-web-ui=Aktualisierte Weboberfläche.
• command ist der Name des CLI-Befehls und der entsprechenden Ansicht, die aufgerufen werden soll, z.B. viewissue (weitere Information finden Sie unter Unterstützte Ansichten, Befehle und Befehlsoptionen)
• selection=id ist die PTC RV&S Element-ID, die für den Befehl erforderlich ist (kann eine komma- oder leerzeichengetrennte Liste von Werten sein, wobei Leerzeichen mit %20 URL-kodiert werden, z.B. selection=12345%2023456%203456)
• option=value ist eine beliebige Anzahl von zusätzlichen Einstellungen (entspricht CLI-Befehlsoptionen (mehrere Werteoptionen als kommagetrennte Liste definieren))
|
|
Kodierung ist für die Werte der Befehlsoptionen erforderlich. Weitere Informationen finden Sie unter Anforderungen und Hinweise zur URL-Kodierung.
|
E-Mail-Benachrichtigungen mit URL-Links des PTC RV&S Clients senden und empfangen
Sie können E-Mail-Benachrichtigungen mit PTC RV&S Client URLs erstellen, indem Sie in einem sichtbaren Feld der GUI oder Weboberfläche auf einen hervorgehobenen Benutzernamen klicken. Dadurch wird die Standard-E-Mail-Anwendung mit einer neuen Nachricht, die an den ausgewählten Benutzer adressiert ist, geöffnet.
Der E-Mail-Betreff ist eine kurze Beschreibung des Elements, und der Text enthält zwei Hyperlinks. Der erste Hyperlink öffnet das jeweilige Element in der PTC RV&S Weboberfläche, und der zweite Hyperlink öffnet dasselbe Element in der PTC RV&S Client GUI. Klicken Sie z.B. auf Benutzer jriley in der Kopfzeile der Ansicht "Elementdetail" des Elements 1234, um eine E-Mail mit den folgenden Links zu generieren:
WEB: https://jriley.abcfinancial.com:7001/im/issues?selection=1234
REFRESHED WEB: https://jriley.abcfinancial.com:7001/extended-web-ui/items/item/1234
GUI: url:integrity://jriley.abcfinancial.com:7001/im/viewissue?selection=1234
|
|
Je nach E-Mail-Anwendung ist der URL-Link des PTC RV&S Clients möglicherweise erst aktiv oder klickbar, wenn der Empfänger die E-Mail-Benachrichtigung erhält.
|
Wenn Sie E-Mails in einer historischen Ansicht generieren, werden in den E-Mail-Betreff und -Text Stand-von-Datum und -Uhrzeit eingefügt, die der historischen Ansicht entsprechen. Klicken Sie z.B. auf der Registerkarte "Verlauf" des Elements 1234 auf Benutzer jriley am July 9, 2012 9:15:25 PM EST, um eine E-Mail-Benachrichtigung mit den folgenden Links zu generieren:
WEB: https://jriley.abcfinancial.com:7001/im/issues?selection=1234&asOf=20120709T211525Z
REFRESHED WEB: https://jriley.abcfinancial.com:7001/extended-web-ui/items/item/1234?asof=2012-07-09T21:15:25Z
GUI: url:integrity://jriley.abcfinancial.com:7001/im/viewissue?selection=1234&asOf=20120709T211525Z
Der Datums- und Zeitstempel ist im ISO-Basisformat 8601 in der koordinierten Weltzeit (UTC, Coordinated Universal Time) und als vollständiges Datum und Uhrzeit mit einem Zeitzonen-Designator angegeben, z.B.:
YYYYMMddThhmmssZ
Dabei gilt:
• YYYYMMdd Jahreszahl vierstellig, Monats- und Tageszahl zweistellig (für Monate und Tage, die nur eine Ziffer umfassen, ist eine führende Null erforderlich)
• T trennt das Datum von der Uhrzeit
• hhmmss Stunden, Minuten und Sekunden zweistellig (für Stunden, Minuten und Sekunden, die nur eine Ziffer umfassen, ist eine führende Null erforderlich)
• Z ist der Zeitzonen-Designator für den UTC-Offset von Null
|
|
Die Uhrzeit wird von 00:00:00 Uhr bis einschließlich 23:59:59 Uhr im 24-stündigen Format angegeben, z.B. ist eine URL, die sich auf die Uhrzeit 13:56:45 Uhr bezieht, identisch mit derjenigen für 1:56:45 PM.
Die Uhrzeit wird außerdem basierend auf der lokalen Zeit des Absenders angegeben. Wenn sich der Empfänger in einer anderen Zeitzone als der Absender befindet, wird das Element in der lokalen Zeitzone angezeigt, sobald auf den Link geklickt und das Element geöffnet wird.
|
Wenn Sie E-Mail-Benachrichtigungen mit URL-Links des PTC RV&S Clients erhalten, beachten Sie Folgendes:
• In Microsoft Outlook-E-Mail-Clients wird die PTC RV&S Client URL als klickbarer Link angezeigt.
• In Microsoft Outlook Web werden klickbare GUI-Links in keinem Browser unterstützt.
• In Lotus Notes-E-Mail-Clients wird die PTC RV&S Client URL als einfacher Text angezeigt, der nicht klickbar ist. Sie können den Text in einen Browser oder das Windows-Dialogfenster > kopieren, um dieselbe Ansicht zu öffnen, die beim Klicken auf einen Link im Microsoft Outlook-Client geöffnet wird.
Revisionsinformationen für PTC RV&S Elemente in clientgenerierter E-Mail
Wenn die Elementrevisionierung aktiviert ist, liefert PTC RV&S auch erweiterte Zusammenfassungsinformationen in E-Mails, die vom PTC RV&S Client generiert werden, wenn Sie auf einen Benutzernamen-Link klicken. Wenn Sie in einem historischen Element auf einen Benutzername-Link klicken, enthält der Betreff der clientgenerierten E-Mail Revisionsinformationen für das Element in folgendem Format:
Typ<Element-ID>: Elementzusammenfassung[Revisionsinformationen] mit Stand von Stand-von-Datum
Wenn die Elementrevisionierung aktiviert ist, enthält der Text der clientgenerierten E-Mails Folgendes:
Mit Stand von: [Revisionsinformationen] Stand-von-Datum
Navigieren Sie, um den historischen Kontext für ein PTC RV&S Element anzuzeigen, zur Registerkarte Verlauf, und klicken Sie auf den Zeitstempel-Link, damit das erforderliche Datum das historische Element öffnet. Anschließend können Sie eine E-Mail-Nachricht über das historische PTC RV&S Element öffnen, indem Sie auf einen Benutzernamen-Link klicken (z.B. Zugewiesener Benutzer, Geändert von oder Erstellt von).
|
|
Revisionsinformationen für das Element sind nicht in der clientgenerierten E-Mail enthalten, wenn Sie auf einen Link im Elementverlauf klicken oder in einem Element arbeiten, in dem die erste Revision nicht festgelegt wurde.
|
Wenn die Elementrevisionierung nicht aktiviert ist, erstellt PTC RV&S das Standardformat für die generierte E-Mail.
Unterstützte Ansichten, Befehle und Befehlsoptionen
In der folgenden Tabelle werden die GUI-Ansichten des PTC RV&S Clients und entsprechenden CLI-Befehle und Befehlsoptionen beschrieben, die in PTC RV&S Client URLs unterstützt werden:
|
GUI-Ansicht des PTC RV&S Clients
|
CLI-Befehl/Unterstützte Optionen
|
URL-Beispiele für die Weboberfläche der ersten Generation
|
URL-Beispiele für die aktualisierte Weboberfläche
|
||||
|---|---|---|---|---|---|---|---|
|
Ansicht "Elemente"
|
im issues--query--queryDefinition--fields--sortField--sortAscending--nosortAscending
|
So öffnen Sie ein Element in der PTC RV&S Client GUI in der Ansicht "Elemente":
integrity://localhost:9001/im/issues?query=MyQuery&fields=Summary%2cPriority&sortField=Priority&sortAscending
|
So öffnen Sie ein Element in der Ansicht "Elemente" der aktualisierten Weboberfläche:
integrity://localhost:9001/extended-web-ui/items?query=MyQuery&fields=Summary%2cPriority&sortField=Priority&sortAscending
Die folgenden Sonderzeichen werden für die Abfragedefinition nicht unterstützt:
• Pluszeichen (+)
• Gleichzeichen (=)
• Doppelpunkt (:)
• Semikolon (;)
• At-Zeichen (@)
• Kaufmännisches Und-Zeichen (&)
• Fragezeichen (?)
• Dollarzeichen ($)
• Komma (,)
• Schrägstrich (/)
• Sternchen (*)
• Ausrufezeichen ( !)
• Einfaches Anführungszeichen (')
• Linke eckige Klammer ([)
• Rechte eckige Klammer (])
• Linke runde Klammer (
• Rechte runde Klammer )
• Linke geschweifte Klammer ({)
• Rechte geschweifte Klammer (})
|
||||
|
Ansicht "Elementdetail"
|
im viewissue--asof
|
So öffnen Sie ein Element in der PTC RV&S Client GUI in der Ansicht "Elementdetail":
integrity://localhost:9001/im/viewissue? selection=1234
So öffnen Sie ein Element in der PTC RV&S Client GUI in der historischen Ansicht "Elementdetail":
integrity://localhost:9001/im/viewissue?selection=1234&asOf=20120730T190323Z
|
So öffnen Sie ein Element in der Ansicht "Elementdetail" der aktualisierten Weboberfläche:
integrity://localhost:9001/extended-web-ui/items/item/1234
So öffnen Sie ein Element in der historischen Ansicht "Elementdetail" der aktualisierten Weboberfläche:
integrity://localhost:9001/extended-web-ui/items/item/1234?asOf=20120730T190323Z
|
||||
|
Dokumentansicht
|
im viewsegment--asof--fields--outlineColumns
|
So öffnen Sie ein Dokument in der PTC RV&S Client GUI in der Dokumentansicht:
integrity://localhost:9001/im/viewsegment?selection=1234&fields=Category%2cText
|
So öffnen Sie ein Dokument in der Ansicht "DocStudio" der aktualisierten Weboberfläche:
integrity://localhost:9001/extended-web-ui/doc-workspace/doc/1234?fields=Category%2cText
|
||||
|
Ansicht "Beziehungen"
|
im relationships--asof--fields
|
So öffnen Sie ein Dokument in der PTC RV&S Client GUI in der Ansicht "Beziehungen":
integrity://localhost:9001/im/relationships?selection=1234&fields=ID%2cType%2cState%2cSummary
|
So öffnen Sie ein Dokument in der Ansicht "Beziehungen" der aktualisierten Weboberfläche:
integrity://localhost:9001/extended-web-ui/relationships/item/1234?fields=ID,Type,State,Summary
|
||||
|
Quellverfolgungs-Viewer
|
im viewsourcetraces--project--asof--devpath--scmHost--scmPort--fields--projectrevision--revision--sortField--sortAscending--nosortAscending
|
So öffnen Sie den Quellverfolgungs-Viewer für das Mitglied im normalen Projekt/Unterprojekt:
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3a%2fproject.pj& revision=1.0
So öffnen Sie den Quellverfolgungs-Viewer für das Mitglied im Varianten-Unterprojekt:
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3A%2Fproject.pj&devpath=TestDevPath&revision=1.0
oder
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=%23c%3A%2F%23d%3DTestDevPath&revision=1.0
So öffnen Sie den Quellverfolgungs-Viewer für das Mitglied im Build-Projekt/-Unterprojekt:
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3A%2Fproject.pj&projectrevision=1.0&revision=1.0
oder
integrity://localhost:9001/si/viewsourcetraces?selection=code.java&project=%23c%3A%2F%23b%3D1.0&revision=1.0
|
Die Funktion zur Konfigurationsverwaltung wird in der aktualisierten Weboberfläche nicht unterstützt
|
||||
|
Quellprojekt
|
si viewproject--project--devpath--projectrevision--filtersubs--nofiltersubs
|
So öffnen Sie die PTC RV&S Client GUI in der Ansicht "Quellprojekt", wobei die leeren Unterprojekte herausgefiltert sind:
integrity://localhost:9001/si/viewproject?project=%2FTestProject%2Fproject.pj&filtersubs
|
Die Funktion zur Konfigurationsverwaltung wird in der aktualisierten Weboberfläche nicht unterstützt
|
||||
|
Quellmitgliedsverlauf
|
si viewhistory--project--devpath--projectrevision
|
So öffnen Sie die PTC RV&S Client GUI in der Ansicht "Quellmitgliedsverlauf":
integrity://localhost:9001/si/viewhistory?selection=source.java&project=%2FTestProject%2Fproject.pj
|
Die Funktion zur Konfigurationsverwaltung wird in der aktualisierten Weboberfläche nicht unterstützt
|
||||
|
Änderungspaket
|
si viewcp
|
So öffnen Sie die PTC RV&S Client GUI in der Ansicht "Änderungspaket":
integrity://localhost:9001/si/viewcp?selection=1234%3A1
|
Die Funktion zur Konfigurationsverwaltung wird in der aktualisierten Weboberfläche nicht unterstützt
|
||||
|
Dashboard
|
im rundashboard--fieldFilter
|
So öffnen Sie die PTC RV&S Client GUI und führen ein angegebenes Dashboard aus:
integrity://localhost:9001/im/rundashboard?selection=%22My%20Dashboard%22
|
So führen Sie ein angegebenes Dashboard in der aktualisierten Weboberfläche aus:
https://ppuwsv-alm18t.ptcnet.ptc.com:1340/extended-web-ui/dashboards/run?selection=__id121
|
||||
|
Bericht
|
im runreport--fieldFilter--asOf--issues--query--param--[no]substituteParams
|
So öffnen Sie die PTC RV&S Client GUI und führen einen angegebenen Bericht aus:
integrity://localhost:9001/im/runreport?selection=%22My%20Report%22
|
So führen Sie einen angegebenen Bericht in der aktualisierten Weboberfläche aus:
https://ppuwsv-alm18t.ptcnet.ptc.com:1340/extended-web-ui/reports/run?selection=12345
|
||||
|
Diagramm
|
im runchart--fieldFilter--query
|
So öffnen Sie die PTC RV&S Client GUI und führen ein angegebenes Diagramm aus:
integrity://localhost:9001/im/runchart?selection=%22My%20Chart%22
|
So führen Sie ein angegebenes Diagramm in der aktualisierten Weboberfläche aus:
https://ppuwsv-alm18t.ptcnet.ptc.com:1340/extended-web-ui/charts/run?selection=__id158
|
|
|
Wenn die Eigenschaft mksis.im.enableautomaticredirectiontoRWI auf true festgelegt ist, werden alle URLs, die auf die Weboberfläche der ersten Generation verweisen, auf die aktualisierte Weboberfläche umgeleitet.
|
Beachten Sie außerdem Folgendes zu den Befehlsoptionen --project, --tvigui und --notvigui:
• Die Option --project unterstützt die Syntaxen "Quellkonfigurationspfad" und "Flacher Pfad". Indem Sie die Syntax "Quellkonfigurationspfad" mit der Option --project verwenden, können Sie Variantenprojekte und Build-Projekte ohne Verwendung der Optionen --devpath und --projectrevision angeben.
Anstatt z.B. die zwei Optionen
project=c%3A%2Fproject.pj&devpath=TestDevPath
anzugeben, können Sie nur die folgende Option angeben
project=%23c%3A%2F%23d%3DTestDevPath
Weitere Informationen zu diesen Syntaxen finden Sie in der Man-Page options der CLI-Man-Pages unter "Konfigurationsverwaltungsprojekte angeben".
• Die Optionen --tvigui und --notvigui sind für alle unterstützten Befehle verfügbar. Diese Optionen steuern, ob die PTC RV&S Client URL den angegebenen Befehl innerhalb der Benutzeroberfläche mit Ansicht im Registerformat (TVI, Tabbed View Interface), d.h. der Client-Ansicht mit vollständiger Unterstützung für Ansichtssätze, oder der unverankerten Ansicht startet.
◦ Wenn --tvigui nicht angegeben ist, wird der Befehl in der TVI-GUI gestartet. Das bedeutet: Die PTC RV&S Client GUI wird mithilfe des aktuellen Ansichtssatzes des Benutzers geöffnet, und die Ansichtssatz-Konfiguration steuert, ob der Befehl in einer unverankerten oder gedockten Ansicht geöffnet wird.
◦ Wenn --notvigui angegeben ist, wird der Befehl in der unverankerten Ansicht gestartet (die TVI-GUI wird nicht gestartet).
|
|
Weitere Informationen zu Ansichtssätze finden Sie unter Informationen zu Ansichtssätzen (GUI).
|
Alle vom System generierten PTC RV&S Client URLs werden auf --tvigui festgelegt. Integrity kann so geändert werden, dass eigenständige URLs (--notvigui) generiert werden. Ihr Administrator muss jedoch die Trigger-Skripte anpassen, die E-Mail-Benachrichtigungen generieren.