Berichts-URLs für Artefaktnutzungsinformationen erstellen

Erstellen Sie eine Berichts-URL, die Informationen zur Nutzung von Artefakten in Erstellungsprozessen ausgibt.

Informationen zu diesem Vorgang

Berichts-URLs für Artefaktnutzungsinformationen verwenden den Berichtspfad artifactUseActivity.

Berichte, die Informationen zur Nutzung von Builds enthalten, schließen die folgenden optionalen Parameter ein:
Tabelle 1. artifactUseActivity: Optionale Parameter
Parameter Zulässige Parameterwerte Beschreibung
fromTime Eine UNIX-Zeitmarke (die Anzahl Sekunden seit 1. Januar 1970, 00:00:00 GMT) Definiert die Startzeit eines Zeitbereichs.
guid Die eindeutige ID für ein Asset, z. B. {EE4545D5–118E-33G4–1D3F-395FDB4EE123} Begrenzt die Ausgabe auf ein bestimmtes Asset. Erfordert den Parameter version.
modifiedSince Sie müssen das Format jjjj-MM-tt'T'HH:mm:ss.SSSZ verwenden, um das Datum anzugeben, seit dem Änderungen vorgenommen wurden (Jahr-Monat-TagTStunde:Minuten:Sekunden.einfaches_Datumsformat; dabei steht 'einfaches_Datumsformat' für Millisekunden (S) und Zeitzone (Z)). Beispiel: 2010-06-07T00:00:00.000-0500 Definiert die Startzeit, seit Änderungen vorgenommen wurden. Verwenden Sie den Parameter 'modifiedSince', wenn Sie Berichts-URLs für Rational Insight-Data-Warehousing erstellen und Sie Änderungen zurückgeben müssen, die seit dem letztmaligen Hinzufügen von Informationen zum Data-Warehouse aufgetreten sind.
teamArea Eine ID für den Teambereich. Eine beliebige Zeichenfolge, die den Teambereich definiert.
toTime Eine UNIX-Zeitmarke (die Anzahl Sekunden seit 1. Januar 1970, 00:00:00 GMT) Definiert die Endzeit eines Zeitbereichs.
uid ID für einen Benutzer Begrenzt die Ausgabe auf den Benutzer, der die Aktivität ausgeführt hat.
version Die Versionsnummer eines Assets, z. B. 1.0 Begrenzt die Ausgabe auf eine bestimmte Version eines Assets. Erfordert den Parameter guid.

Dieser Bericht kann mit der Syntax der Berichts-URL für Assetinformationen verknüpft werden. Sie können entweder die GUID und den Parameter 'version' verwenden oder diese URL mit dem Parameter in der Assetinformationen-URL verknüpfen.

Ergebnisse

Der Bericht zur Artefaktnutzung gibt die folgenden Assetdaten zurück:
  • Benutzerinformationen
  • Aktivitätstyp-ID
  • Zeitmarke
  • Beschreibung
  • Titel der Aktivität
  • Ein Link zu dem Objekt, für das die Aktivität ausgeführt wurde (z. B. Asset oder Bewertung)
  • Team-Server
  • Teambereich
  • Teamtyp
  • Teaminformation
  • Eclipse-Projekt
  • Artefakt

Beispiel

Beispiel: Assetnutzungsinformationen - Verwenden Sie die folgende Beispiel-URL zum Erstellen der Berichts-URL, mit der Artefaktnutzungsinformationen für die Assets mit der angegebenen GUID und Version abgerufen werden:
http://example.com:9080/ram.ws/reporting/artifactUseActivity:guid={EE4545D5–118E-33G4–1D3F-395FDB4EE123},version=1.0

Feedback