Berichts-URLs für Buildnutzungsinformationen definieren

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

Informationen zu diesem Vorgang

Berichts-URLs für Buildnutzungsinformationen verwenden den Berichtspfad buildUseActivity.

Berichte, die Informationen zur Buildnutzung enthalten, schließen die folgenden optionalen Parameter ein:
Tabelle 1. buildUseActivity: Optionale Parameter
Parameter Zulässige Parameterwerte Beschreibung
buildID ID für den Build. Eine eindeutige Kennung für Ihren Build.
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 der Ä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 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 Buildnutzung 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
  • Build-ID
  • Artefakt

Beispiel

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

Feedback