Aracılığıyla paylaş

OData Analytics kullanarak temel sorguları tanımlama

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

İlgilendiğiniz verileri döndürmek üzere OData sorguları oluşturmak için Azure DevOps için Analytics'i kullanabilirsiniz. Bu sorguları tarayıcınızda veya Excel veya Power BI gibi istemci yazılımlarında çalıştırabilirsiniz.

Bu makale, Azure Boards iş izleme varlık kümelerini almaya yönelik sorgulara odaklanır, ancak ilkeler diğer varlık kümelerini sorgulamak için geçerlidir. Daha fazla bilgi için bkz. Analiz için OData sorguları oluşturma ve Azure Boards Analytics için Metadata başvurusu.

Bu öğretici size şunları nasıl yapacağınızı gösteriyor:

  • Verileri ile veya olmadan öğe sayılarını döndüren sorguları tanımlayın.
  • Belirli özelliklere ait verileri almak için seçeneği seçin.
  • Verileri belirli özelliklere göre filtreleyin.
  • Kimlik, Alan Yolu ve Yineleme Yolu gibi gezinti özellikleri için veri döndürme.
  • expand Yan tümceler ve expand iç içe deyimler kullanın.
  • Tarih aralıklarını sorgulama.
  • orderby Sonuçları sıralamak için seçeneğini kullanın.

Not

Analiz hizmeti, Azure DevOps Services içindeki tüm hizmetler için üretimde otomatik olarak etkinleştirilir ve desteklenir. Power BI tümleştirmesi ve Analiz hizmetinin OData akışına erişim genel olarak kullanılabilir. Analytics OData akışını kullanmanız ve geri bildirim sağlamanız teşvik edilir.

Kullanılabilir veriler sürüme bağlıdır. OData API'sinin desteklenen en son sürümü, v2.0en son önizleme sürümü ise şeklindedir 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 hizmetinin OData akışına erişim genel olarak kullanılabilir. Analytics OData akışını kullanmanız ve geri bildirim sağlamanız teşvik edilir. Azure DevOps Server 2019'dan yükseltme yaparsanız, yükseltme sırasında Analytics hizmetini yükleyebilirsiniz.

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

Önkoşullar

Kategori Gereksinimler
Erişim seviyeleri - Proje Üyesi.
- En az Temel erişim.
İ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

Sorguyu çalıştıran kullanıcının tüm projelere erişimi olmadığında projeler arası sorgular başarısız olur. Gereksinimler hakkında daha fazla bilgi için bkz. Proje ve kuruluş kapsamındaki sorgular.

Not

Bu makaledeki OData sorguları, Azure DevOps Services, https://analytics.dev.azure.com/için tanımlanan sorgu URL'sini kullanır. OData sorgulama hakkında bilgi edinmek için sorgularda kendi kuruluşunuzun ve proje adlarını değiştirin.

Şirket içi bir sunucu için, sunucunuzu ve proje koleksiyonunuzu https://<servername>/<ProjectCollectionName>/temel alan bir URL ile benzer sorgular oluşturabilirsiniz. Daha fazla bilgi için bkz. Analiz için OData sorguları oluşturma.

Öğe sayısını alma

Başka bilgiler eklemeden yalnızca bir kuruluşta veya projede tanımlanan öğe veya varlık sayısını döndürmek $apply=aggregate($count as Count) için sorgu seçeneğini uygulayın. Aşağıdaki sorgular bir kuruluştaki projelerin, iş öğelerinin, alan yollarının ve kullanıcıların 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)

Yukarıdaki sorgular, kuruluştaki fabrikam projeler için aşağıdaki örneğe benzer sonuçlar döndürür:

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

Öğe sayısını ve verilerini alma

Öğeler için seçili verilerle birlikte öğe sayısını döndürmek için, deyiminde $count=trueselect sorgu seçeneğini belirtin. 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.

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

Not

Belirtilen varlık türü için tanımlanan tüm özellikleri döndürmek için yan tümcesi olmadan $count=true kullanabilirsinizselect. Ancak, $select veya $apply yan tümcesi eklemezseniz, VS403507: The specified query does not include a $select or $apply clause which is recommended for all queries. Details on recommended query patterns are available here: https://go.microsoft.com/fwlink/?linkid=861060 gibi bir uyarı alırsınız. Kullanım sınırlarıyla karşılaşmamak için sorgularınıza her zaman bir $select veya $apply yan tümcesi ekleyin.

Örneğin, aşağıdaki sorgu Fabrikam Fiber projesindeki kullanıcıların sayısını ve Kullanıcı Adlarını istemektedir:

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/Users?$count=true&$select=UserName

Sorgu, 5 sahip kullanıcı sayısını döndürür.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Users(UserName)",
  "@odata.count": 5,
  "value": [
    {
      "UserName": "Microsoft.VisualStudio.Services.TFS"
    },
    {
      "UserName": "fabrikamfiber1@hotmail.com"
    },
    {
      "UserName": "Jamal Hartnett"
    },
    {
      "UserName": "fabrikamfiber5@hotmail.com"
    },
    {
      "UserName": "fabrikamfiber2@hotmail.com"
    }
  ]
}

Belirli özellikleri veya alanları seçme

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 öğelerini döndürmek için sorgunuza yan tümcesini $select=WorkItemId,WorkItemType,Title,State ekleyin.

$select yan tümcesi, adlandırılmış alanlara karşılık gelen özellik adlarını belirtir. OData sorgularındaki özellik adları hem aralıklara hem de büyük/küçük harfe dikkat gerektirir. İş Öğesi Kimliği gibi özellik görünen adları boşluk içerse de, resmi özellik adları boşluk içeremez.

Özellik adları ve etiketleri hakkında daha fazla bilgi için bkz. Azure Boards için meta veri başvurusu. Özel alan özelliklerinin nasıl etiketlendiğini anlamak için bkz. Özel özellikler.

Aşağıdaki örnek sorgu, Fabrikam Fiber projesindeki ilk üç iş öğesi için iş öğesi kimliklerini, başlıklarını ve durumlarını istemektedir.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_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/fabrikamprime/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State)",
  "value": [
    {
      "WorkItemId": 31,
      "Title": "About screen",
      "WorkItemType": "Task",
      "State": "New"
    },
    {
      "WorkItemId": 30,
      "Title": "Change background color",
      "WorkItemType": "Task",
      "State": "Active"
    },
    {
      "WorkItemId": 32,
      "Title": "Standardize on form factors",
      "WorkItemType": "Task",
      "State": "Active"
    }
  ]
}

Verileri 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 ekleyin. Aşağıdaki filtre yan tümcesi yalnızca Devam Ediyor durumundaki Özellik iş öğesi türlerini döndürür.

/WorkItems?$filter=WorkItemType eq 'Feature' and State eq 'In Progress'

Aşağıdaki örnek sorgu yalnızca Devam Ediyor durumundaki Özellik iş öğelerinin İş Öğesi Kimliği, İş Öğesi Türü, Başlık ve Durum değerlerini döndürmeyi belirtir.

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

Birkaç filtre yan tümcesi belirtme

Bir and yan tümcesinde birkaç filtre belirtmek için or ve $select kullanabilirsiniz. Örneğin, aşağıdaki sorgu Yeni, Taahhüt Edilmiş veya Etkin durumlarındaki User Story, Hata veya özel tür Backlog Çalışması türündeki iş öğelerinden çeşitli alanları belirtir. Filtre yan tümcelerini gerektiği gibi gruplandırmak için parantez kullanın.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,Title,AssignedTo,State&$filter=(WorkItemType eq 'User Story' or WorkItemType eq 'Bug' or WorkItemType eq 'Backlog Work') and (State eq 'New' or State eq 'Committed' or State eq 'Active')

Sorgu aşağıdaki sonuçlar gibi verileri döndürür:


{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,Title,AssignedTo,State)",
  "value": [
    {
      "WorkItemId": 210,
      "Title": "Slow response on form",
      "State": "Active"
    },
    ...
    {
      "WorkItemId": 160,
      "Title": "Game store testing",
      "State": "New"
    }
  ]
}

Ayrıca, contains, startswith ve endswith gibi çeşitli işlevleri $select yan tümcelerinde uygulayabilirsiniz. Bkz . Desteklenen işlevler.

Sorgu Alanı Yolu veya Yineleme Yolu özellikleri

Belirli bir alan yolunun veya yineleme yolunun AreaSK, IterationSKveya diğer özelliklerini aramak için aşağıdaki sorguları kullanın.

Belirli bir alan yolu için AreaSK'yi döndürün

Aşağıdaki sorgu, AreaSK alan yolu için tanımlanan Fabrikam Fiber\Production Planning\Web özelliğini istemektedir. Alanlar varlık kümesinin diğer tanımlı özelliklerini görmek için bkz. Alanlar.

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

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

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Areas(AreaSK)",
  "value": [
    {
      "AreaSK": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

Belirli bir yineleme yolu için IterationSK'yi döndürme

Aşağıdaki sorgu, IterationSK yineleme yolu için tanımlanan Fabrikam Fiber\3Week Sprints\Sprint 3 özelliğini döndürür. Yinelemeler varlık kümesinin diğer tanımlı özelliklerini görmek için bkz. Yinelemeler.

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

Gezinti özelliklerine göre filtreleme

Gezinti özellikleri, varlık türleri arasındaki ilişkileri temsil eder. Filtre ölçütlerinizin bir parçası olarak bir gezinti özelliği belirttiğinizde, gezinti özelliğinin tam yolunu belirtmeniz gerekir. Örneğin, aşağıdaki yan tümce, gezinti özelliği için belirtilen Iteration temel alarak iş öğelerini filtreler.

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

Iteration gezinti özelliğidir ve IterationPath ilgilendiğim alandır. Iteration/IterationPath özelliği için IterationPath tam yoldur.

Aşağıdaki örnek sorgu, için tam yolu Fabrikam Fiber\3Week Sprints\Sprint 3belirterek yineleme yolunun Iteration/IterationPath altındaki ilk beş iş öğesinden veri istemektedir.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$top=5&$filter=Iteration/IterationPath eq 'Fabrikam Fiber\3Week Sprints\Sprint 3'&$select=WorkItemId, WorkItemType, Title, State&$orderby=WorkItemId asc

Yukarıdaki örnek sorgu, ilgili bir varlık olduğundan Iteration veri döndürmezIteration. Gezinti özellikleri Identity, Area ve Iteration gibi özelliklerin ifadeleri kullanılarak $select doğrudan erişilemez. Verileri ilişkili varlıklardan döndürmek için $expand ifadelerini kullanmanız gerekir.

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

Aşağıdaki örnek sorgu, genişletilmiş 480 veriler de dahil olmak üzere iş öğesi kimliğiyle Iterationilişkili bilgileri istemektedir.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration

Sorgu, genişletilmiş Iteration özellikten tüm alanları içeren 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,Iteration)",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "ProjectSK": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "IterationSK": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationId": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationName": "Sprint 3",
        "Number": 276,
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3",
        "StartDate": "2025-12-04T00:00:00-12:00",
        "EndDate": "2025-12-25T23:59:59.999-12:00",
        "IterationLevel1": "Fabrikam Fiber",
        "IterationLevel2": "3Week Sprints",
        "IterationLevel3": "Sprint 3",
        "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": false,
        "AnalyticsUpdatedDate": "2025-10-22T17:28:14.7166667Z"
      }
    }
  ]
}

Genişletme deyimlerinde seçme özelliğini kullanma

Genişletilmiş bir özellik istediğinizden daha fazla veri döndürüyorsa, özelliğine bir $select deyim ekleyin.

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

Örneğin, aşağıdaki örnek sorgu genişletilmiş IterationName özellikten yalnızca IterationPath ve Iteration verilerini seçer.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration($select=IterationName,IterationPath)

Sorgu 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,Iteration(IterationName,IterationPath))",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "IterationName": "Sprint 3",
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3"
      }
    }
  ]
}

Aşağıdaki tabloda, gezinti özelliklerinde birkaç alan seçmek için $expand ve $select yan tümcelerinin nasıl kullanılacağı gösterilmektedir. Örneğin, $expand=AssignedTo($select=UserName) gezinti özelliğinde Kullanıcı Adı alanının Atanan Kişi özelliğini döndürmek için kullanırsınız.

Tür alanı Başvurulan özellik Örnek yan tümceler
Tarih ve Saat 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)

Virgülle ayrılmış bir liste kullanarak bir tek $expand yan tümcede genişleteceğiniz birkaç özellik belirtebilirsiniz.

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

İç içe genişletme ifadelerini kullanın

İç içe OData $expand deyimlerini kullanabilirsiniz. Örneğin, aşağıdaki sorgu bir yinelemenin içinde olduğu projeyi görüntülemek için iç içe $expand deyimleri kullanır.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration($expand=Project)

Sorgu 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,Iteration)",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "ProjectSK": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "IterationSK": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationId": "cccccccc-2222-3333-4444-dddddddddddd",
        "IterationName": "Sprint 3",
        "Number": 276,
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3",
        "StartDate": "2025-12-04T00:00:00-12:00",
        "EndDate": "2025-12-25T23:59:59.999-12:00",
        "IterationLevel1": "Fabrikam Fiber",
        "IterationLevel2": "3Week Sprints",
        "IterationLevel3": "Sprint 3",
        "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": false,
        "AnalyticsUpdatedDate": "2025-10-22T17:28:14.7166667Z",
        "Project": {
          "ProjectSK": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectName": "Fabrikam Fiber",
          "AnalyticsUpdatedDate": "2025-10-28T20:27:13.5833333Z",
          "ProjectVisibility": "Private"
        }
      }
    }
  ]
}

Deyimleri $select ekleyebilirsiniz, örneğin yalnızca IterationName ve IterationPath değerini Iteration gibi döndürebilirsiniz:

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$filter=WorkItemId eq 480&$select=WorkItemId,WorkItemType,Title,State&$expand=Iteration($select=IterationName,IterationPath;$expand=Project)

Bu sorgu 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,Iteration(IterationName,IterationPath,Project))",
  "value": [
    {
      "WorkItemId": 480,
      "Title": "Add animated emoticons",
      "WorkItemType": "User Story",
      "State": "New",
      "Iteration": {
        "IterationName": "Sprint 3",
        "IterationPath": "Fabrikam Fiber\\3Week Sprints\\Sprint 3",
        "Project": {
          "ProjectId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
          "ProjectName": "Fabrikam Fiber",
          "AnalyticsUpdatedDate": "2025-10-28T20:27:13.5833333Z",
          "ProjectVisibility": "Private"
        }
      }
    }
  ]
}

Sonuçlar yalnızca IterationName ve IterationPath öğesinden Iteration'yi,Project sonuçlarının içinde iç içe nesne olarak gösterilen Iteration ile birlikte gösterir.

Not

Bir $expand yan tümceyi bir $select deyimin içine iç içe yerleştirdiğinizde, hatadan kaçınmak için iç içe geçmiş kısımdan ; önce noktalı virgül kullanmalısınız.

Tarih aralığını sorgulama

Aşağıdaki örnek sorgu, son Değiştirme Tarihi 1 Ocak 2025'ten büyük veya buna eşit olan iş öğelerini döndürür.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2025-01-01Z

Aşağıdaki örnek sorgu, son Değiştirme Tarihi 31 Ekim ile 7 Kasım 2025 arasında gerçekleşen iş öğelerini döndürür.

https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/WorkItems?$select=WorkItemId,WorkItemType,Title,State&$filter=ChangedDate ge 2025-10-31Z&ChangedDate le 2025-11-07Z

Sonuçları sıralama

$orderby Sonuçlarınızı sıralama seçeneğini belirtin veya sonuçların döndürüleceği sırayı belirtin. veya anahtar sözcüklerini ascdesckullanarak artan veya azalan düzende sıralayabilirsiniz. Aşağıdaki tabloda bazı örnekler gösterilmektedir.

Sıralama ölçütü Cümle
İş öğ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ım

Proje & kuruluş kapsamındaki sorgular

İlgili içerik

  • Last updated on