İngilizce dilinde oku

Aracılığıyla paylaş


Dashboards - Replace Dashboards

Sağlanan gruptaki panoların adını ve konumunu güncelleştirin ve atlanmış panoları kaldırın. Pano içeriğini değiştirmez.

HTTP
PUT https://{instance}/{collection}/{project}/{team}/_apis/dashboard/dashboards?api-version=4.1-preview.2

URI Parametreleri

Name İçinde Gerekli Tür Description
collection
path True

string

Team Foundation Server koleksiyonunun adı.

instance
path True

string

TFS sunucu adı ({server:port})

project
path True

string

Proje Kimliği veya proje adı

team
path

string

Ekip kimliği veya ekip adı

api-version
query True

string

Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '4.1-preview.2' olarak ayarlanmalıdır.

İstek Gövdesi

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

dashboardEntries

DashboardGroupEntry[]

Pano Grubu tarafından tutulan Panoların listesi

permission

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

teamDashboardPermission

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

url

string

Yanıtlar

Name Tür Description
200 OK

DashboardGroup

başarılı işlem

Güvenlik

accessToken

Kişisel erişim belirteci. Parola olarak kullanıcı adı ve belirteç için herhangi bir değer kullanın.

Type: basic

Örnekler

Sample Request

HTTP
PUT https://{instance}/{collection}/Fabrikam-Fiber-Git/_apis/dashboard/dashboards?api-version=4.1-preview.2

{
  "widgets": []
}

Sample Response

JSON
{
  "widgets": [],
  "url": "https://fabrikam:8080/tfs/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf",
  "_links": {
    "self": {
      "href": "https://fabrikam:8080/tfs/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf"
    },
    "group": {
      "href": "https://fabrikam:8080/tfs/Fabrikam-Fiber-Git/_apis/Dashboard/Groups/999ef3b4-93e1-4086-86c2-5e8bd24512c7"
    }
  },
  "id": "7562562a-4f9f-4258-94a9-b048b1c817cf",
  "name": "Dashboard98",
  "position": 2,
  "refreshInterval": 5
}

Tanımlar

Name Description
Dashboard

Pano modeli.

DashboardGroup

Sahiple ilişkili panoların listesini açıklar. Şu anda ekipler pano gruplarına sahip.

DashboardGroupEntry

Pano grubu girdisi, Pano çevresinde kaydırma (gerekli mi?)

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

LightboxOptions

Lightbox yapılandırması

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

SemanticVersion

major.minor.patch formunun: http://semver.org/adresinde açıklandığı gibi bir yapıt için sürüm oluşturma.

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

Widget

Pencere öğesi verileri

WidgetPosition
WidgetSize

Dashboard

Pano modeli.

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

description

string

Panonun açıklaması.

eTag

string

Düzenleme çakışması algılaması için kullanılan sunucu tanımlı sürüm izleme değeri.

id

string

Panonun kimliği. Oluşturma zamanında hizmet tarafından sağlanır.

name

string

Panonun adı.

ownerId

string

Pano için Sahip kimliği. Eski panolar için bu, panoyla ilişkilendirilmiş ekibin benzersiz tanımlayıcısı olacaktır.

position

integer

Panonun bir pano grubu içindeki konumu. Oluşturma zamanında ayarlanmazsa, konum hizmet tarafından belirlenir.

refreshInterval

integer

İstemcinin panoyu otomatik olarak yenileme aralığı. Dakika cinsinden ifade edilir.

url

string

widgets

Widget[]

Panodaki Pencere Öğeleri kümesi.

DashboardGroup

Sahiple ilişkili panoların listesini açıklar. Şu anda ekipler pano gruplarına sahip.

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

dashboardEntries

DashboardGroupEntry[]

Pano Grubu tarafından tutulan Panoların listesi

permission

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

teamDashboardPermission

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

url

string

DashboardGroupEntry

Pano grubu girdisi, Pano çevresinde kaydırma (gerekli mi?)

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

description

string

Panonun açıklaması.

eTag

string

Düzenleme çakışması algılaması için kullanılan sunucu tanımlı sürüm izleme değeri.

id

string

Panonun kimliği. Oluşturma zamanında hizmet tarafından sağlanır.

name

string

Panonun adı.

ownerId

string

Pano için Sahip kimliği. Eski panolar için bu, panoyla ilişkilendirilmiş ekibin benzersiz tanımlayıcısı olacaktır.

position

integer

Panonun bir pano grubu içindeki konumu. Oluşturma zamanında ayarlanmazsa, konum hizmet tarafından belirlenir.

refreshInterval

integer

İstemcinin panoyu otomatik olarak yenileme aralığı. Dakika cinsinden ifade edilir.

url

string

widgets

Widget[]

Panodaki Pencere Öğeleri kümesi.

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

Name Tür Description
edit

string

manage

string

managePermissions

string

none

string

LightboxOptions

Lightbox yapılandırması

Name Tür Description
height

integer

İstenen ışık kutusunun piksel cinsinden yüksekliği

resizable

boolean

Lightbox yeniden boyutlandırmasına izin vermek için True, lightbox'ın yeniden boyutlandırılmasına izin vermek için false, varsayılan olarak false olarak ayarlanır.

width

integer

İstenen ışık kutusunun piksel cinsinden genişliği

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name Tür Description
links

object

Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak göstermek istiyoruz.

SemanticVersion

major.minor.patch formunun: http://semver.org/adresinde açıklandığı gibi bir yapıt için sürüm oluşturma.

Name Tür Description
major

integer

Uyumsuz API değişiklikleri yaptığınızda ana sürüm

minor

integer

İşlevselliği geriye dönük uyumlu bir şekilde eklediğinizde ikincil sürüm

patch

integer

Geriye dönük uyumlu hata düzeltmeleri yaptığınızda düzeltme eki sürümü

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

Name Tür Description
create

string

delete

string

edit

string

managePermissions

string

none

string

read

string

Widget

Pencere öğesi verileri

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

allowedSizes

WidgetSize[]

Pencere öğesi için izin verilen boyutları ifade eder. Bu, kullanıcı pencere öğesini yapılandırmak istediğinde doldurulur

areSettingsBlockedForUser

boolean

Pano Hizmeti'nden Read-Only Özelliği. Geçerli kullanıcı için ayarların engellenip engellenmediğini gösterir.

artifactId

string

Özellik yapıtının benzersiz tanımlayıcısına başvurur. Belirli bir yapıtı sabitlemek+sabitlemek için kullanılır.

configurationContributionId

string

configurationContributionRelativeId

string

contentUri

string

contributionId

string

Sağlanan Pencere Öğesi Yapılandırmasını tanımlayan temel katkının kimliği.

dashboard

Dashboard

Pencere öğesi düzeyinde API'ler için pano düzeyinde ETag alışverişi desteklemek üzere isteğe bağlı kısmi pano içeriği

eTag

string

id

string

isEnabled

boolean

isNameConfigurable

boolean

lightboxOptions

LightboxOptions

Lightbox yapılandırması

loadingImageUrl

string

name

string

position

WidgetPosition

settings

string

settingsVersion

SemanticVersion

major.minor.patch formunun: http://semver.org/adresinde açıklandığı gibi bir yapıt için sürüm oluşturma.

size

WidgetSize

typeId

string

url

string

WidgetPosition

Name Tür Description
column

integer

row

integer

WidgetSize

Name Tür Description
columnSpan

integer

Pano kılavuzu sütunlarında ifade edilen pencere öğesinin Genişliği.

rowSpan

integer

Pano kılavuzu satırlarında ifade edilen pencere öğesinin yüksekliği.