Dashboards - Replace Dashboard

Referenz

Service:: Dashboard

API Version:: 7.1-preview.3

Ersetzen Sie die Konfiguration für die angegebene Dashboard. Ersetzt die Widgetliste im Dashboard nur, wenn die Eigenschaft angegeben wird.

PUT https://dev.azure.com/{organization}/{project}/{team}/_apis/dashboard/dashboards/{dashboardId}?api-version=7.1-preview.3

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dashboardId	path	True	string uuid	ID des zu ersetzenden Dashboard.
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path	True	string	Projekt-ID oder Projektname
team	path		string	Team-ID oder Teamname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1-preview.3" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
dashboardScope	DashboardScope	Entität, für die der Dashboard bereichsbezogener Ist.
description	string	Beschreibung des Dashboard.
eTag	string	Serverdefinierter Versionsnachverfolgungswert, der zum Bearbeiten der Kollisionserkennung verwendet wird.
groupId	string	ID der Gruppe für einen Dashboard. Bei Dashboards im Teambereich ist dies der eindeutige Bezeichner für das Team, das dem Dashboard zugeordnet ist. Für projektbezogene Dashboards ist diese Eigenschaft leer.
id	string	ID des Dashboards. Vom Dienst zur Erstellung bereitgestellt.
lastAccessedDate	string	Datum des letzten Zugriffs im Dashboard.
modifiedBy	string	Id der Person, die das Dashboard geändert hat.
modifiedDate	string	Datum der letzten Änderung des Dashboards.
name	string	Name des Dashboards.
ownerId	string	ID des Besitzers für eine Dashboard. Bei Dashboards im Teambereich ist dies der eindeutige Bezeichner für das Team, das dem Dashboard zugeordnet ist. Für projektbezogene Dashboards ist dies der eindeutige Bezeichner für die Benutzeridentität, die dem Dashboard zugeordnet ist.
position	integer	Position des Dashboard innerhalb einer Dashboard Gruppe. Wenn die Einstellung zum Erstellungszeitpunkt nicht festgelegt wird, wird die Position vom Dienst festgelegt.
refreshInterval	integer	Intervall für den Client, um die Dashboard automatisch zu aktualisieren. Ausgedrückt in Minuten.
url	string
widgets	Widget[]	Der Satz von Widgets auf dem Dashboard.

Antworten

Name	Typ	Beschreibung
200 OK	Dashboard	Erfolgreicher Vorgang

Sicherheit

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Beschreibung
vso.dashboards_manage	Ermöglicht die Verwaltung von Team-Dashboard Informationen

Definitionen

Name	Beschreibung
Dashboard	Modell eines Dashboards.
DashboardScope	Dashboardbereich. Kann entweder Project oder Project_Team sein.
LightboxOptions	Lightbox-Konfiguration
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
SemanticVersion	Versionsverwaltung für ein Artefakt, wie unter beschrieben: http://semver.org/, der Form major.minor.patch.
Widget	Widgetdaten
WidgetPosition
WidgetSize

Dashboard

Modell eines Dashboards.

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
dashboardScope	DashboardScope	Entität, für die der Dashboard bereichsbezogener Ist.
description	string	Beschreibung des Dashboard.
eTag	string	Serverdefinierter Versionsnachverfolgungswert, der zum Bearbeiten der Kollisionserkennung verwendet wird.
groupId	string	ID der Gruppe für einen Dashboard. Bei Dashboards im Teambereich ist dies der eindeutige Bezeichner für das Team, das dem Dashboard zugeordnet ist. Für projektbezogene Dashboards ist diese Eigenschaft leer.
id	string	ID des Dashboards. Vom Dienst zur Erstellung bereitgestellt.
lastAccessedDate	string	Datum des letzten Zugriffs im Dashboard.
modifiedBy	string	Id der Person, die das Dashboard geändert hat.
modifiedDate	string	Datum der letzten Änderung des Dashboards.
name	string	Name des Dashboards.
ownerId	string	ID des Besitzers für eine Dashboard. Bei Dashboards im Teambereich ist dies der eindeutige Bezeichner für das Team, das dem Dashboard zugeordnet ist. Für projektbezogene Dashboards ist dies der eindeutige Bezeichner für die Benutzeridentität, die dem Dashboard zugeordnet ist.
position	integer	Position des Dashboard innerhalb einer Dashboard Gruppe. Wenn die Einstellung zum Erstellungszeitpunkt nicht festgelegt wird, wird die Position vom Dienst festgelegt.
refreshInterval	integer	Intervall für den Client, um die Dashboard automatisch zu aktualisieren. Ausgedrückt in Minuten.
url	string
widgets	Widget[]	Der Satz von Widgets auf dem Dashboard.

DashboardScope

Dashboardbereich. Kann entweder Project oder Project_Team sein.

Name	Typ	Beschreibung
collection_User	string	[VERALTET] Das Dashboard ist auf den Sammlungsbenutzer ausgerichtet.
project	string	Das Dashboard ist auf das Projekt ausgerichtet.
project_Team	string	Das Dashboard ist auf das Team ausgerichtet.

LightboxOptions

Lightbox-Konfiguration

Name	Typ	Beschreibung
height	integer	Höhe der gewünschten Lightbox in Pixel
resizable	boolean	True, um die Größe der Lightbox zuzulassen, false, um die Größe des Leuchtfelds nicht zuzulassen, standardmäßig auf false.
width	integer	Breite des gewünschten Lightboxfelds in Pixel

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

SemanticVersion

Versionsverwaltung für ein Artefakt, wie unter beschrieben: http://semver.org/, der Form major.minor.patch.

Name	Typ	Beschreibung
major	integer	Hauptversion, wenn Sie inkompatible API-Änderungen vornehmen
minor	integer	Nebenversion beim abwärtskompatiblen Hinzufügen von Funktionen
patch	integer	Patchversion bei abwärtskompatiblen Fehlerbehebungen

Widgetdaten

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
allowedSizes	WidgetSize[]	Bezieht sich auf die zulässigen Größen für das Widget. Diese wird aufgefüllt, wenn der Benutzer das Widget konfigurieren möchte.
areSettingsBlockedForUser	boolean	Read-Only Eigenschaft vom Dashboarddienst aus. Gibt an, ob Einstellungen für den aktuellen Benutzer blockiert sind.
artifactId	string	Bezieht sich auf den eindeutigen Bezeichner eines Featureartefakts. Wird zum Anheften und Aufheben eines bestimmten Artefakts verwendet.
configurationContributionId	string
configurationContributionRelativeId	string
contentUri	string
contributionId	string	Die ID des zugrunde liegenden Beitrags, der die angegebene Widgetkonfiguration definiert.
dashboard	Dashboard	Optionale partielle Dashboard Inhalte, um den Austausch von ETag-Versionen auf Dashboard-Ebene gegen APIs auf Widgetebene zu unterstützen
eTag	string
id	string
isEnabled	boolean
isNameConfigurable	boolean
lightboxOptions	LightboxOptions	Lightbox-Konfiguration
loadingImageUrl	string
name	string
position	WidgetPosition
settings	string
settingsVersion	SemanticVersion	Versionsverwaltung für ein Artefakt, wie unter beschrieben: http://semver.org/, der Form major.minor.patch.
size	WidgetSize
typeId	string
url	string

WidgetPosition

Name	Typ	Beschreibung
column	integer
row	integer

WidgetSize

Name	Typ	Beschreibung
columnSpan	integer	Die Breite des Widgets, ausgedrückt in Dashboard Rasterspalten.
rowSpan	integer	Die Höhe des Widgets, ausgedrückt in Dashboard Rasterzeilen.

Freigeben über