Dashboards - Create

Odwołanie

Service:: Dashboard

API Version:: 7.1-preview.3

Utwórz dostarczony pulpit nawigacyjny.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
team	path		string	Identyfikator zespołu lub nazwa zespołu
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna być ustawiona na wartość "7.1-preview.3", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
_links	ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
dashboardScope	DashboardScope	Jednostka, do której jest zakres pulpitu nawigacyjnego.
description	string	Opis pulpitu nawigacyjnego.
eTag	string	Wartość śledzenia wersji zdefiniowanej przez serwer służącą do edytowania wykrywania kolizji.
groupId	string	Identyfikator grupy dla pulpitu nawigacyjnego. W przypadku pulpitów nawigacyjnych o zakresie zespołu jest to unikatowy identyfikator zespołu skojarzonego z pulpitem nawigacyjnym. W przypadku pulpitów nawigacyjnych o zakresie projektu ta właściwość jest pusta.
id	string	Identyfikator pulpitu nawigacyjnego. Udostępniane przez usługę w czasie tworzenia.
lastAccessedDate	string	Data ostatniego dostępu do pulpitu nawigacyjnego.
modifiedBy	string	Identyfikator osoby, która zmodyfikowała pulpit nawigacyjny.
modifiedDate	string	Data ostatniej modyfikacji pulpitu nawigacyjnego.
name	string	Nazwa pulpitu nawigacyjnego.
ownerId	string	Identyfikator właściciela pulpitu nawigacyjnego. W przypadku pulpitów nawigacyjnych o zakresie zespołu jest to unikatowy identyfikator zespołu skojarzonego z pulpitem nawigacyjnym. W przypadku pulpitów nawigacyjnych o zakresie projektu jest to unikatowy identyfikator tożsamości użytkownika skojarzonej z pulpitem nawigacyjnym.
position	integer	Pozycja pulpitu nawigacyjnego w grupie pulpitów nawigacyjnych. Jeśli pozycja nie jest ustawiana w czasie tworzenia, pozycja jest podejmowana przez usługę.
refreshInterval	integer	Interwał odświeżania pulpitu nawigacyjnego przez klienta. Wyrażone w minutach.
url	string
widgets	Widget[]	Zestaw widżetów na pulpicie nawigacyjnym.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Dashboard	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.dashboards_manage	Umożliwia zarządzanie informacjami o pulpicie nawigacyjnym zespołu

Przykłady

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/{project}/_apis/dashboard/dashboards?api-version=7.1-preview.3

{
  "name": "test",
  "position": 5,
  "widgets": [
    {
      "name": "Team Members renamed",
      "position": {
        "row": 2,
        "column": 2
      },
      "size": {
        "rowSpan": 1,
        "columnSpan": 2
      },
      "settings": null,
      "settingsVersion": {
        "major": 1,
        "minor": 0,
        "patch": 0
      },
      "contributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.TeamMembersWidget"
    }
  ]
}

Sample Response

Status code:: 200

{
  "id": "29653dd2-c18a-4d19-8333-e556c5b8d025",
  "name": "test",
  "position": 5,
  "eTag": "1",
  "widgets": [
    {
      "name": "Team Members renamed",
      "position": {
        "row": 2,
        "column": 2
      },
      "size": {
        "rowSpan": 1,
        "columnSpan": 2
      },
      "settings": null,
      "settingsVersion": {
        "major": 1,
        "minor": 0,
        "patch": 0
      },
      "contributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.TeamMembersWidget"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/Dashboards/29653dd2-c18a-4d19-8333-e556c5b8d025",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/Dashboards/29653dd2-c18a-4d19-8333-e556c5b8d025"
    },
    "group": {
      "href": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/Dashboards"
    },
    "widget": [
      {
        "href": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/dashboards/29653dd2-c18a-4d19-8333-e556c5b8d025/Widgets/456afb86-ecf6-49cf-bbcc-1ab7d0fc14b2"
      }
    ]
  }
}

Definicje

Nazwa	Opis
Dashboard	Model pulpitu nawigacyjnego.
DashboardScope	Zakres pulpitu nawigacyjnego. Może to być projekt lub Project_Team
LightboxOptions	Konfiguracja usługi Lightbox
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
SemanticVersion	przechowywanie wersji artefaktu zgodnie z opisem w temacie : http://semver.org/, formularza major.minor.patch.
Widget	Dane widżetu
WidgetPosition
WidgetSize

Dashboard

Model pulpitu nawigacyjnego.

Nazwa	Typ	Opis
_links	ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
dashboardScope	DashboardScope	Jednostka, do której jest zakres pulpitu nawigacyjnego.
description	string	Opis pulpitu nawigacyjnego.
eTag	string	Wartość śledzenia wersji zdefiniowanej przez serwer służącą do edytowania wykrywania kolizji.
groupId	string	Identyfikator grupy dla pulpitu nawigacyjnego. W przypadku pulpitów nawigacyjnych o zakresie zespołu jest to unikatowy identyfikator zespołu skojarzonego z pulpitem nawigacyjnym. W przypadku pulpitów nawigacyjnych o zakresie projektu ta właściwość jest pusta.
id	string	Identyfikator pulpitu nawigacyjnego. Udostępniane przez usługę w czasie tworzenia.
lastAccessedDate	string	Data ostatniego dostępu do pulpitu nawigacyjnego.
modifiedBy	string	Identyfikator osoby, która zmodyfikowała pulpit nawigacyjny.
modifiedDate	string	Data ostatniej modyfikacji pulpitu nawigacyjnego.
name	string	Nazwa pulpitu nawigacyjnego.
ownerId	string	Identyfikator właściciela pulpitu nawigacyjnego. W przypadku pulpitów nawigacyjnych o zakresie zespołu jest to unikatowy identyfikator zespołu skojarzonego z pulpitem nawigacyjnym. W przypadku pulpitów nawigacyjnych o zakresie projektu jest to unikatowy identyfikator tożsamości użytkownika skojarzonej z pulpitem nawigacyjnym.
position	integer	Pozycja pulpitu nawigacyjnego w grupie pulpitów nawigacyjnych. Jeśli pozycja nie jest ustawiana w czasie tworzenia, pozycja jest podejmowana przez usługę.
refreshInterval	integer	Interwał odświeżania pulpitu nawigacyjnego przez klienta. Wyrażone w minutach.
url	string
widgets	Widget[]	Zestaw widżetów na pulpicie nawigacyjnym.

DashboardScope

Zakres pulpitu nawigacyjnego. Może to być projekt lub Project_Team

Nazwa	Typ	Opis
collection_User	string	[PRZESTARZAŁE] Pulpit nawigacyjny jest w zakresie użytkownika kolekcji.
project	string	Zakres pulpitu nawigacyjnego dotyczy projektu.
project_Team	string	Zakres pulpitu nawigacyjnego jest ograniczona do zespołu.

LightboxOptions

Konfiguracja usługi Lightbox

Nazwa	Typ	Opis
height	integer	Wysokość żądanego światła w pikselach
resizable	boolean	Wartość True, aby umożliwić zmianę rozmiaru lightbox, wartość false nie zezwala na zmianę rozmiaru lightbox, domyślnie ma wartość false.
width	integer	Szerokość żądanego lightboxu w pikselach

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

SemanticVersion

przechowywanie wersji artefaktu zgodnie z opisem w temacie : http://semver.org/, formularza major.minor.patch.

Nazwa	Typ	Opis
major	integer	Wersja główna po wprowadzeniu niezgodnych zmian interfejsu API
minor	integer	Wersja pomocnicza w przypadku dodawania funkcji w sposób zgodny z poprzednimi wersjami
patch	integer	Wersja poprawek w przypadku wprowadzania poprawek usterek zgodnych z poprzednimi wersjami

Dane widżetu

Nazwa	Typ	Opis
_links	ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
allowedSizes	WidgetSize[]	Odwołuje się do dozwolonych rozmiarów widżetu. Jest to wypełniane, gdy użytkownik chce skonfigurować widżet
areSettingsBlockedForUser	boolean	Read-Only właściwość z usługi pulpitu nawigacyjnego. Wskazuje, czy ustawienia są blokowane dla bieżącego użytkownika.
artifactId	string	Odwołuje się do unikatowego identyfikatora artefaktu funkcji. Służy do przypinania i odpinania określonego artefaktu.
configurationContributionId	string
configurationContributionRelativeId	string
contentUri	string
contributionId	string	Identyfikator bazowego udziału definiujący podaną konfigurację widżetu.
dashboard	Dashboard	Opcjonalna częściowa zawartość pulpitu nawigacyjnego w celu obsługi wymiany elementu ETag na poziomie pulpitu nawigacyjnego dla interfejsów API na poziomie widżetu
eTag	string
id	string
isEnabled	boolean
isNameConfigurable	boolean
lightboxOptions	LightboxOptions	Konfiguracja usługi Lightbox
loadingImageUrl	string
name	string
position	WidgetPosition
settings	string
settingsVersion	SemanticVersion	przechowywanie wersji artefaktu zgodnie z opisem w temacie : http://semver.org/, formularza major.minor.patch.
size	WidgetSize
typeId	string
url	string

WidgetPosition

Nazwa	Typ	Opis
column	integer
row	integer

WidgetSize

Nazwa	Typ	Opis
columnSpan	integer	Szerokość widżetu wyrażona w kolumnach siatki pulpitu nawigacyjnego.
rowSpan	integer	Wysokość widżetu wyrażona w wierszach siatki pulpitu nawigacyjnego.

Udostępnij za pośrednictwem