OData Analytics kullanarak temel sorguları tanımlama

Makale
01/10/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure DevOps için Analiz'i kullanarak, ilgilendiğiniz verileri döndürmek için temel ve filtrelenmiş sorgular oluşturabilirsiniz. Bu sorguları doğrudan tarayıcınızda veya Power BI'da çalıştırabilirsiniz.

Bu makalede, Azure Boards Analytics için Analiz ve Meta Veri başvurusu için OData sorguları oluşturma başlığı altında sağlanan bilgiler derlenmiştir. Ayrıca, bu makaledeki sorgular iş izleme varlık kümelerini almaya odaklanmıştır, ancak ilkeler diğer varlık kümelerini sorgulamak için geçerlidir.

Bu makalede, aşağıdaki verileri döndüren sorguları tanımlamayı öğreneceksiniz:

Öğe sayısı (başka veri yok)
Öğe ve veri sayısı
Alanlar veya Yineleme Yolları için tanımlanan özellikler
Seçili sütunlar veya alanlar
Filtrelenmiş veriler
Kimlik, Alan Yolu ve Yineleme Yolu alanları için veri döndürme
Gezinti özelliğine göre filtreleme
Tarih aralığını sorgulama
Genişletme deyimlerini iç içe yerleştirme
Sonuçları sıralama, sıralama seçeneği

Not

Analiz hizmeti, tüm Azure DevOps Services için üretimde otomatik olarak etkinleştirilir ve desteklenir. Power BI tümleştirmesi ve Analiz Hizmeti'nin OData akışına erişim genel olarak kullanılabilir. Bunu kullanmanızı ve bize geri bildirim göndermenizi öneririz. Kullanılabilir veriler sürüme bağlıdır. Desteklenen en son sürüm, v2.0en son önizleme sürümü ise sürümüdür v4.0-preview. Daha fazla bilgi için bkz . OData API sürümü oluşturma.

Not

Analytics hizmeti, Azure DevOps Server 2020 ve sonraki sürümleri için tüm yeni proje koleksiyonları için otomatik olarak yüklenir ve üretimde desteklenir. Power BI tümleştirmesi ve Analiz Hizmeti'nin OData akışına erişim genel olarak kullanılabilir. Bunu kullanmanızı ve bize geri bildirim göndermenizi öneririz. Azure DevOps Server 2019'dan yükselttiyseniz yükseltme sırasında Analytics hizmetini yükleyebilirsiniz.

Kullanılabilir veriler sürüme bağlıdır. Desteklenen en son sürüm, v2.0en son önizleme sürümü ise sürümüdür v4.0-preview. Daha fazla bilgi için bkz . OData API sürümü oluşturma.

Not

Analiz hizmeti, Azure DevOps Server 2019 için önizleme aşamasındadır. Bir proje koleksiyonu için etkinleştirebilir veya yükleyebilirsiniz . Power BI tümleştirmesi ve Analiz Hizmeti'nin OData akışına erişim Önizleme aşamasındadır. Bunu kullanmanızı ve bize geri bildirim göndermenizi öneririz.

Önkoşullar

Erişim: En az Temel erişimi olan bir projenin üyesi olun.
İzinler: Varsayılan olarak, proje üyeleri Analytics'i sorgulama ve görünüm oluşturma iznine sahiptir.
Hizmet ve özellik etkinleştirme ve genel veri izleme etkinlikleriyle ilgili diğer önkoşullar hakkında daha fazla bilgi için bkz . Analytics'e erişim izinleri ve önkoşulları.

Not

Bu makalede, Azure DevOps Services için OData sorgu URL'si tanımlanmıştır. Şirket içi sunucuya benzer bir sorgu oluşturmak için Analiz için OData sorguları oluşturma konusunda sağlanan yönergelere bakın. Tarayıcınızı kullanarak OData sorgulamaya alışmak için kuruluşunuz ve projeniz için sağlanan sorguları ayarlamanızı öneririz.

Öğe sayısını döndürme (başka veri döndürme)

Bir kuruluşta veya projede tanımlanan öğe veya varlık sayısı hakkında bilgi edinmek için sorgu seçeneğini belirtin $apply=aggregate($count as Count) . Örneğin, aşağıdaki sorgular bir kuruluş için tanımlanan proje, iş öğesi, Alan Yolu ve kullanıcı sayısını döndürür.

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/Projects?$apply=aggregate($count as Count)
https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItems?$apply=aggregate($count as Count)
https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/Areas?$apply=aggregate($count as Count)
https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/Users?$apply=aggregate($count as Count)

İpucu

Sorguyu çalıştıran kullanıcının tüm projelere erişimi olmadığında projeler arası sorgular başarısız olur. Project ve kuruluş kapsamındaki sorgulardaki gereksinimler hakkında daha fazla bilgi edinin.

Proje sayısı

@odata.context	"https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#Projects(Count)"
value	
   0	
     @odata.id	null
     Count	    28

İş öğesi sayısı

@odata.context	"https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#WorkItems(Count)"
value	
  0	
     @odata.id	null
     Count	    1166

Alan sayısı

@odata.context	"https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#Areas(Count)"
value	
  0	
     @odata.id	null
     Count	    70

Kullanıcı sayısı

@odata.context	"https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#Areas(Count)"
value	
  0	
     @odata.id	null
     Count	    16

Öğe ve veri sayısını döndürme

Öğelerin sayısını döndürmek ve öğelerin verilerini seçmek için sorgu seçeneğini belirtin $count=true . Örneğin, aşağıdaki sorgular belirtilen özelliklerle birlikte bir proje için tanımlanan iş öğelerinin, Alan Yollarının ve kullanıcıların sayısını döndürür. Geçerli özellikler için bkz . Azure Boards Analytics için meta veri başvurusu ve Takvim tarihi, Azure DevOps Analytics için Proje ve Kullanıcı meta veri başvurusu.

İpucu

Döndürülecek özellikleri belirtmezseniz, Analytics belirtilen varlık türü için tanımlanan tüm özellikleri döndürür.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v4.0-preview/WorkItems?$count=true&$select=WorkItemId,Title,WorkItemType 
https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v4.0-preview/Areas?$count=true&$select=AreaName,AreaPath 
https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v4.0-preview/Users?$count=true&$select=UserName,UserEmail

Alanlar veya Yineleme özellikleri

Alan Yolu veya Yineleme Yolu'nun veya veya IterationSKdiğer özelliğini aramak AreaSK için aşağıdaki sorguları kullanın.

Belirli bir Alan Yolu için AreaSK değerini döndürme

Aşağıdaki sorgu, Fabrikam Fiber\Service Delivery\Internet Alan Yolu için tanımlanan özelliğin döndürülmesi AreaSK için belirtir. Varlık kümesi için tanımlanan diğer özellikleri belirtmek için Areas bkz . Azure Boards Analytics, Alanlar için meta veri başvurusu.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Areas?$filter=AreaPath eq 'Fabrikam Fiber\Service Delivery\Internet' &$select=AreaSK

Sorgu aşağıdaki verileri döndürür.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Areas(AreaSK)",
  "value": [
    {
      "AreaSK": "637dc203-0549-4415-9663-b6358ac27d21"
    }
  ]
}

Belirli bir Yineleme Yolu için IterationSK'yi döndürme

Aşağıdaki sorgu, Fabrikam Fiber\Release 1\Sprint 3 Yineleme Yolu için tanımlanan özelliğin döndürülmesi IterationSK için belirtir. Varlık kümesi için tanımlanan diğer özellikleri belirtmek için Iterations bkz . Azure Boards Analytics, Yinelemeler için meta veri başvurusu.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Iterations?$filter=IterationPath eq 'Fabrikam Fiber\Release 1\Sprint 3' &$select=IterationSK

Sorgu aşağıdaki verileri döndürür.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Iterations(IterationSK)",
  "value": [
    {
      "IterationSK": "862e961a-ac7a-4fcc-9ebc-8afd0c12fed5"
    }
  ]
}

Belirli özellikleri veya alanları döndürme

Belirli özellikleri veya iş öğesi alanlarını döndürmek için özellik adlarını belirten bir $select yan tümce ekleyin.

Örneğin, İş Öğesi Kimliği, İş Öğesi Türü, Başlık ve İş öğelerinin durumu bilgilerini döndürmek için sorgunuza aşağıdaki yan tümceyi ekleyin. Bu yan tümce, adlandırılmış alanlara karşılık gelen özellikleri belirtir.

Not

Özellik adları boşluk içermez. Boşluk eklerseniz sorgunuz başarısız olur. OData sorguları hem aralık hem de büyük/küçük harfe dikkat gerektirir. Özel alan özelliklerinin nasıl etiketlendiğini anlamak için bkz . Azure Boards için meta veri başvurusu, Özel özellikler.

Burada ilk üç iş öğesinin döndürüleceğini belirteceğiz.

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$top=3

Analiz aşağıdaki verileri döndürür.

@odata.context	"https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State)"
value	
   0	
      WorkItemId    462
      Title         "Test case"
      WorkItemType  "Test Case"
      State         "Design"
   1	
      WorkItemId	   491
      Title          "Change color settings"
      WorkItemType   "Shared Steps"
      State          "Active"
   2	
      WorkItemId	   461
      Title          "Test impediment"
      WorkItemType   "Impediment"
      State          "Open"

Verilerinizi filtreleme

Bir varlık kümesini belirli öğeleri döndürecek şekilde filtrelemek için, öğelerin karşılaması gereken ölçütleri belirten bir $filter yan tümce belirtin. Son sorguyu oluşturarak, burada yalnızca Devam Ediyor durumundaki Özellik iş öğesi türlerini döndürmek için bir filtre yan tümcesi ekleyeceğiz.

/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=State eq 'In Progress'

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemType eq 'Feature' and State eq 'In Progress'&$select=WorkItemId,Title,AssignedTo,State

Analiz aşağıdaki verileri döndürür.

  
@odata.context	"https://analytics.dev.azure.com/kelliott/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,Title,State)"
value	
  0	
      WorkItemId	380
      Title	"Refresh web look, feel, performance factors"
      State	"In Progress"
  1	
      WorkItemId	480
      Title	"Customer Phone - Phase 1"
      State	"In Progress"
  2	
      WorkItemId	493
      Title	"Change initial view"
      State	"In Progress"
  3	
      WorkItemId	479
      Title	"Customer Web - Phase 1"
      State	"In Progress"
  4	
      WorkItemId	551
      Title	"Mobile feedback"
      State	"In Progress"

Birkaç filtre yan tümcesi belirtme

ve OR kullanarak birkaç filtre yan tümcesi belirtebilirsinizAND.

Örneğin, aşağıdaki sorgu Yeni, Kaydedilmiş veya Etkin durumlarındaki Kullanıcı Hikayesi, Hata ve Kapsam Çalışması (özel bir iş öğesi türü) türünde iş öğelerinin döndürülmesi için belirtir. Filtre yan tümcelerini gerektiği gibi gruplandırmak için parantez kullanın.

Ayrıca, , startswithendswith ve daha fazlası gibi containsçeşitli işlevleri uygulayabilirsiniz. Desteklenen OData özellikleri ve yan tümceleri, Desteklenen işlevler bölümüne bakın.

Kimlik, Alan Yolu ve Yineleme Yolu alanları için veri döndürme

Seçme özellikleri gezinti özellikleriyle ilişkilendirilir ve deyimi kullanılarak $select doğrudan erişilemez. İlgilendiğiniz verileri döndürmek için bir $expand deyimi kullanmanız gerekir. Bu özellikler genellikle kendi çeşitli özellikleriyle ilişkilendirilir. Örneğin, Kimlik alanlarıyla, kullanıcı adını veya kullanıcı e-postasını döndürmeyi belirtebilirsiniz.

Aşağıdaki tabloda, bu özelliklerden birkaçının nasıl genişletilmesine ilişkin örnekler verilmiştir.

Tür alanları	Başvurulan özellik	Dahil etmek için örnek yan tümceler
DateTime	`DateSK`	`$expand=CreatedDate($select=Date)` veya `$expand=CreatedDate($select=WeekStartingDate)`
Kimlik	`UserSK`	`$expand=AssignedTo($select=UserName)` veya `$expand=AssignedTo($select=UserEmail)`
Alan	`AreaSK`	`$expand=Area($select=AreaName)` veya `$expand=Area($select=AreaPath)`
Yineleme	`IterationSK`	`$expand=Iteration($select=IterationName)` veya `$expand=Iteration($select=IterationPath)` veya `$expand=Iteration($select=StartDate)`
Proje	`ProjectSK`	`$expand=Project($select=ProjectName)`
Takım	`TeamSK`	`$expand=Teams($select=TeamName)`

Genişletilmesi gereken çeşitli özellikleri belirtmek için, bunları virgülle ayrılmış bir liste içindeki tek bir genişletme yan tümcesinde belirtirsiniz.

$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

Filtre ölçütlerinizin bir parçası olarak bir gezinti özelliği belirttiğinizde, bunu gerekli biçimde belirtmeniz gerekir.

Örneğin, aşağıdaki yan tümce iş öğelerinin proje için tanımlanan Yineleme 1'e göre filtrelenmesini belirtir.

/WorkItems?$filter=Iteration/IterationPath eq 'Project Name\Iteration 1'

Bu örnekte gezinti Iteration özelliği adıdır ve IterationPath yinelemenin tam yoluna karşılık gelir. Filtre olarak başka bir varlık kullanmak için gezinti özelliğini, ardından eğik çizgi ve ardından filtrelenecek alanın adını ekleyin.

İşte tam OData sorgusu:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?$filter=Iteration/IterationPath eq 'Project Name\Iteration 1'

Fabrikam Fiber\Service Delivery\Voice Area Path altındaki ilk beş iş öğesinin döndürülme isteğinde bulunan başka bir örnek aşağıda verilmiştir.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$top=5&$filter=Area/AreaPath eq 'Fabrikam Fiber\Service Delivery\Voice'&$select=WorkItemId, WorkItemType, Title, State&$orderby=WorkItemId asc

@odata.context	"https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State)"
value	
  0	
     WorkItemId	361
     Title        "Hello World Web Site"
     WorkItemType	"Product Backlog Item"
     State        "Removed"
  1	
     WorkItemId	362
     Title        "Resume"
     WorkItemType	"Product Backlog Item"
     State        "New"
  2	
     WorkItemId	363
     Title        "Welcome back page"
     WorkItemType	"Product Backlog Item"
     State        "Done"
  3	
     WorkItemId	365
     Title        "Pause"
     WorkItemType	"Feature"
     State        "New"
  4	
     WorkItemId	374
     Title        "Fix performance issues"
     WorkItemType	"Task"
     State        "To Do"

İpucu

Gezinti özelliğini doğrudan bir $select deyimde kullanamazsınız. Bunun yerine kullanmanız $expandgerekir.

Yineleme Yolu için önceki filtreleme örneği, ilgili bir varlıkta bulunduğundan yineleme yolunu döndürmez. İlgili bir varlığa veri döndürmek için bir $expand deyim ekleyin:

/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=WorkItemId eq 10000&$expand=Iteration

Burada iş öğesi kimliği 480'e atanan bilgileri döndüren bir örnek verilmiş.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&&$expand=Iteration
   
@odata.context	"https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration)"
value	
  0	
      WorkItemId           480
      Title                "Customer Phone - Phase 1"
      WorkItemType	       "Feature"
      State	               "In Progress"
      Iteration	
          ProjectSK	       "56af920d-393b-4236-9a07-24439ccaa85c"
          IterationSK	       "c7063041-ff3a-4d7f-bb46-c433c7030d59"
          IterationId	       "c7063041-ff3a-4d7f-bb46-c433c7030d59"
          IterationName	   "Sprint 1"
          Number	            55297
          IterationPath	    "Fabrikam Fiber\\Release 1\\Sprint 1"
          StartDate	        "2022-01-17T00:00:00-08:00"
          EndDate	            "2022-02-04T23:59:59.999-08:00"
          IterationLevel1	    "Fabrikam Fiber"
          IterationLevel2	    "Release 1"
          IterationLevel3	    "Sprint 1"
          IterationLevel4	    null
          IterationLevel5	    null
          IterationLevel6	    null
          IterationLevel7	    null
          IterationLevel8	    null
          IterationLevel9	    null
          IterationLevel10	null
          IterationLevel11	null
          IterationLevel12	null
          IterationLevel13	null
          IterationLevel14	null
          Depth	            2
          IsEnded	        	true
      AnalyticsUpdatedDate	"2022-01-18T22:18:58.17Z"

Gördüğünüz gibi, yineleme yolu sonuç olarak genişletilir ve tüm yineleme verileri döndürülür. Büyük olasılıkla istediğinizden daha fazla veridir.

Daha az veri döndürmek için yinelemeye karşı bir $select deyim de ekleyin:

/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=WorkItemId eq 10000&$expand=Iteration($select=Name,IterationPath)

Ardından aşağıdaki verileri döndürür.

{
  "@odata.context":"https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration,Iteration(Name,IterationPath))",
  "value":[
    {
      "WorkItemId":10000,
      "WorkItemType":"Task",
      "Title":"Some title",
      "State":"Completed",
      "Iteration":{
        "Name":"Sprint 55",
        "IterationPath":"Fabrikam\\Sprints\\Sprint 55"
      }
    }
  ]
}

Tarih aralığını sorgulama

Aşağıdaki örnek, Değiştirme Tarihi 1 Ocak 2021'e eşit olan iş öğelerini döndürür.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2021-01-01Z

Aşağıdaki örnek, Değiştirme Tarihi 26 Nisan ile 30 Nisan 2021 arasında olan iş öğelerini döndürür.

https://analytics.dev.azure.com{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2021-04-26Z&ChangedDate le 2021-04-30Z

Genişletme deyimlerini iç içe yerleştirme

OData'da deyimleri iç içe $expand yerleştirebilirsiniz. Örneğin, yinelemenin parçası olduğu projeyi görüntülemek için önceki sorgu deyimini yazabilirsiniz:

/WorkItems?$filter=WorkItemId eq 10000&$expand=Iteration($expand=Project)

Aşağıdaki JSON değerini döndürür:

{
  "@odata.context":"https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata#WorkItems",
  "value":[
    {
      "WorkItemId":10000,
      "Revision":3,
      "Watermark":283397,
      "Title":"Production deployment and testing for Entitlement API v2 and Subscriber database",
      "WorkItemType":"Task",
      "ChangedDate":"2014-07-10T19:29:58.41Z",
      "CreatedDate":"2014-04-19T22:44:58.31Z",
      "State":"Completed",
      "Reason":"Completed",
      "Priority":2,
      "CompletedWork":10.0,
      "OriginalEstimate":20.0,
      "Count":1,
      "Iteration":{
        "IterationId":"7a2c246e-fc62-41af-ad18-62332017bc46",
        "Name":"Sprint 55",
        "Number":13021,
        "IterationPath":"Fabrikam\\Sprints\\Sprint 55",
        "StartDate":"2013-09-23T00:00:00Z",
        "EndDate":"2013-10-11T00:00:00Z",
        "IterationLevel1":"Fabrikam",
        "IterationLevel2":" Sprints",
        "IterationLevel3":"Sprint 55",
        "Level":2,
        "IsDeleted":false,
        "Project":{
          "ProjectId":"b924d696-3eae-4116-8443-9a18392d8544",
          "ProjectName":"Fabrikam",
          "IsDeleted":false
        }
      }
    }
  ]
}

ve $select deyimlerini de birleştirebilirsiniz$expand. Örneğin, önceki sorguyu yalnızca Yineleme Adı ve Yineleme Yolu'nu döndürecek şekilde değiştirebilirsiniz:

/WorkItems?$filter=WorkItemId eq 10000&$expand=Iteration($select=IterationId,IterationPath;$expand=Project)

Aşağıdaki JSON değerini döndürür:

{
  "@odata.context":"https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata#WorkItems(Iteration(IterationId,IterationPath,Project))",
  "value":[
    {
      "WorkItemId":10000,
      "Revision":3,
      "Watermark":283397,
      "Title":"Production deployment and testing for Entitlement API v2 and Subscriber database","WorkItemType":"Task",
      "ChangedDate":"2014-07-10T19:29:58.41Z",
      "CreatedDate":"2014-04-19T22:44:58.31Z",
      "State":"Completed",
      "Reason":"Completed",
      "Priority":2,
      "CompletedWork":10.0,
      "OriginalEstimate":20.0,
      "Count":1,
      "Iteration":{
        "IterationId":"7a2c246e-fc62-41af-ad18-62332017bc46","IterationPath":"Fabrikam\\Sprints\\Sprint 55",
        "Project":{
          "ProjectId":"b924d696-3eae-4116-8443-9a18392d8544",
          "ProjectName":"Fabrikam",
          "IsDeleted":false
        }
      }
    }
  ]
}

Buradaki sonucun yalnızca IterationId ve IterationPath'i gösterdiğine ve Project'in JSON sonucu içinde iç içe yerleştirilmiş bir nesne olduğuna dikkat edin. Dikkate alınacak bir diğer önemli öğe de URL'nin kendisidir. Deyimini $select ve yan $expand tümcesini kullanırken, önce noktalı virgül (;) $expand) kullanmanız gerekir. Diğer her şey hataya neden olur.

Sonuçları sırala seçeneği `orderby`

$orderby Sonuçlarınızı sıralama seçeneğini belirtin veya sonuçların döndürüldiği sırayı belirtin. Sırasıyla veya anahtar sözcüklerini asc desckullanarak artan veya azalan düzende sıralayabilirsiniz. Bazı örnekler gösterilir

Sıralama ölçütü	Eklenecek yan tümce
İş öğesi kimliği	`/WorkItems?$orderby=WorkItemId`
Azalan iş öğesi kimliği	`/WorkItems?$orderby=WorkItemId desc`
İş öğesi türü ve Durum	`/WorkItems?$orderby=WorkItemType,State`

Sonraki adımlar

Proje & kuruluş kapsamındaki sorgular

Aracılığıyla paylaş

OData Analytics kullanarak temel sorguları tanımlama

Önkoşullar

Öğe sayısını döndürme (başka veri döndürme)

Proje sayısı

İş öğesi sayısı

Alan sayısı

Kullanıcı sayısı

Öğe ve veri sayısını döndürme

Alanlar veya Yineleme özellikleri

Belirli bir Alan Yolu için AreaSK değerini döndürme

Belirli bir Yineleme Yolu için IterationSK'yi döndürme

Belirli özellikleri veya alanları döndürme

Verilerinizi filtreleme

Birkaç filtre yan tümcesi belirtme

Kimlik, Alan Yolu ve Yineleme Yolu alanları için veri döndürme

Gezinti özelliğine göre filtreleme

Tarih aralığını sorgulama

Genişletme deyimlerini iç içe yerleştirme

Sonuçları sırala seçeneği `orderby`

Sonraki adımlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

OData Analytics kullanarak temel sorguları tanımlama

Önkoşullar

Öğe sayısını döndürme (başka veri döndürme)

Proje sayısı

İş öğesi sayısı

Alan sayısı

Kullanıcı sayısı

Öğe ve veri sayısını döndürme

Alanlar veya Yineleme özellikleri

Belirli bir Alan Yolu için AreaSK değerini döndürme

Belirli bir Yineleme Yolu için IterationSK'yi döndürme

Belirli özellikleri veya alanları döndürme

Verilerinizi filtreleme

Birkaç filtre yan tümcesi belirtme

Kimlik, Alan Yolu ve Yineleme Yolu alanları için veri döndürme

Gezinti özelliğine göre filtreleme

Tarih aralığını sorgulama

Genişletme deyimlerini iç içe yerleştirme

Sonuçları sırala seçeneği orderby

Sonraki adımlar

İlgili makaleler

Geri Bildirim

Ek kaynaklar

Sonuçları sırala seçeneği `orderby`