Queries - Update

Reference

Služba:: Work Item Tracking

Verze rozhraní API:: 7.1

Aktualizujte dotaz nebo složku. To vám umožní aktualizovat, přejmenovat a přesunout dotazy a složky.

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}?api-version=7.1

S volitelnými parametry:

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/queries/{query}?$undeleteDescendants={$undeleteDescendants}&api-version=7.1

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
query	path	True	string	ID nebo cesta, které má dotaz aktualizovat.
api-version	query	True	string	Verze rozhraní API, která se má použít. Pokud chcete použít tuto verzi rozhraní API, měla by být nastavená na hodnotu 7.1.
$undeleteDescendants	query		boolean	Odstranění podřízených položek této složky Je důležité si uvědomit, že to nepřinese zpět změny oprávnění, které byly dříve použity u potomků.

Text požadavku

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST
children	QueryHierarchyItem[]	Podřízené položky dotazu ve složce dotazu.
clauses	WorkItemQueryClause	Klauzule pro plochý dotaz.
columns	WorkItemFieldReference[]	Sloupce dotazu.
createdBy	IdentityReference	Identita, která vytvořila položku dotazu.
createdDate	string (date-time)	Po vytvoření položky dotazu
filterOptions	LinkQueryMode	Režim dotazu odkazu.
hasChildren	boolean	Pokud se jedná o složku dotazu, označuje, jestli obsahuje nějaké podřízené položky.
id	string (uuid)	ID položky dotazu.
isDeleted	boolean	Označuje, jestli je tato položka dotazu odstraněna. Nastavením této hodnoty na hodnotu false u odstraněné položky dotazu ji zrušíte. Zrušením zrušení dotazu nebo složky se nepřenesou zpět změny oprávnění, které se na něj dříve použily.
isFolder	boolean	Označuje, jestli se jedná o složku dotazu nebo dotaz.
isInvalidSyntax	boolean	Označuje, jestli je hodnota WIQL tohoto dotazu neplatná. Příčinou může být neplatná syntaxe nebo neplatná cesta k oblasti nebo iteraci.
isPublic	boolean	Označuje, jestli je tato položka dotazu veřejná nebo soukromá.
lastExecutedBy	IdentityReference	Identita, která dotaz naposledy spustila.
lastExecutedDate	string (date-time)	Kdy byl dotaz naposledy spuštěn.
lastModifiedBy	IdentityReference	Identita, která položku dotazu naposledy upravila.
lastModifiedDate	string (date-time)	Kdy byla položka dotazu naposledy změněna.
linkClauses	WorkItemQueryClause	Klauzule dotazu odkazu.
name	string	Název položky dotazu.
path	string	Cesta k položce dotazu.
queryRecursionOption	QueryRecursionOption	Možnost rekurze pro použití ve stromovém dotazu.
queryType	QueryType	Typ dotazu.
sortColumns	WorkItemQuerySortColumn[]	Sloupce řazení dotazu.
sourceClauses	WorkItemQueryClause	Zdrojové klauzule ve stromu nebo dotazu na propojení s jedním segmentem.
targetClauses	WorkItemQueryClause	Cílové klauzule ve stromu nebo dotazu na propojení s jedním segmentem.
url	string
wiql	string	Text WIQL dotazu

Odpovědi

Name	Typ	Description
200 OK	QueryHierarchyItem	úspěšná operace

Zabezpečení

oauth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL tokenu: 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

Rozsahy

Name	Description
vso.work_write	Uděluje možnost číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cesty k jiným metadatům souvisejícím se sledováním pracovních položek, spouštění dotazů a přijímání oznámení o událostech pracovních položek prostřednictvím volání služeb.

Příklady

Rename a folder

Rename a query

Undelete a query or folder

Update a query

Rename a folder

Ukázkový požadavek

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=7.1

{
  "name": "Website"
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website",
  "path": "Shared Queries/Website",
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:59.077Z",
  "isFolder": true,
  "hasChildren": true,
  "isPublic": true,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/eb5c1e25-9b3e-4416-a833-e500122882c7"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Rename a query

Ukázkový požadavek

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=7.1

{
  "name": "Website"
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website",
  "path": "Shared Queries/Website",
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:59.077Z",
  "isFolder": true,
  "hasChildren": true,
  "isPublic": true,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/eb5c1e25-9b3e-4416-a833-e500122882c7"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Undelete a query or folder

Ukázkový požadavek

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?$undeleteDescendants=true&api-version=7.1

{
  "isDeleted": false
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "8a8c8212-15ca-41ed-97aa-1d6fbfbcd581",
  "name": "Website",
  "path": "My Queries/Website",
  "createdBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "createdDate": "2016-06-01T16:58:56.323Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:59:01.86Z",
  "isFolder": true,
  "hasChildren": true,
  "children": [
    {
      "id": "342f0f44-4069-46b1-a940-3d0468979ceb",
      "name": "Active Bugs",
      "path": "My Queries/Website/Active Bugs",
      "createdBy": {
        "displayName": "Jamal Hartnett",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      },
      "createdDate": "2016-06-01T16:58:56.64Z",
      "lastModifiedBy": {
        "displayName": "Jamal Hartnett",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      },
      "lastModifiedDate": "2016-06-01T16:59:01.82Z",
      "queryType": "flat",
      "columns": [
        {
          "referenceName": "System.Id",
          "name": "ID",
          "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Id"
        },
        {
          "referenceName": "System.Title",
          "name": "Title",
          "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Title"
        },
        {
          "referenceName": "System.State",
          "name": "State",
          "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
        }
      ],
      "sortColumns": [
        {
          "field": {
            "referenceName": "Microsoft.VSTS.Common.Priority",
            "name": "Priority",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.Priority"
          },
          "descending": false
        },
        {
          "field": {
            "referenceName": "System.CreatedDate",
            "name": "Created Date",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.CreatedDate"
          },
          "descending": true
        }
      ],
      "wiql": "select [System.Id], [System.Title], [System.State] from WorkItems where [System.WorkItemType] = 'Bug' and [System.State] = 'Active' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc",
      "isPublic": false,
      "clauses": {
        "logicalOperator": "and",
        "clauses": [
          {
            "field": {
              "referenceName": "System.WorkItemType",
              "name": "Work Item Type",
              "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.WorkItemType"
            },
            "operator": {
              "referenceName": "SupportedOperations.Equals",
              "name": "="
            },
            "value": "Bug"
          },
          {
            "field": {
              "referenceName": "System.State",
              "name": "State",
              "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
            },
            "operator": {
              "referenceName": "SupportedOperations.Equals",
              "name": "="
            },
            "value": "Active"
          }
        ]
      },
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
        },
        "html": {
          "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=342f0f44-4069-46b1-a940-3d0468979ceb"
        },
        "parent": {
          "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
        },
        "wiql": {
          "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/wiql/342f0f44-4069-46b1-a940-3d0468979ceb"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
    }
  ],
  "isPublic": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/3c65fbc1-d427-48ce-9091-633dde9e27e2"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
}

Update a query

Ukázkový požadavek

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/queries/{query}?api-version=7.1

{
  "wiql": "Select [System.Id], [System.Title], [System.State] From WorkItems Where [System.WorkItemType] = 'Bug' AND [System.State] = 'Active' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc"
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "342f0f44-4069-46b1-a940-3d0468979ceb",
  "name": "Active Bugs",
  "path": "Shared Queries/Website team/Active Bugs",
  "createdDate": "2016-06-01T16:58:56.64Z",
  "lastModifiedBy": {
    "displayName": "Jamal Hartnett",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      }
    },
    "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "uniqueName": "fabrikamfiber4@hotmail.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
    "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
  },
  "lastModifiedDate": "2016-06-01T16:58:58.44Z",
  "queryType": "flat",
  "columns": [
    {
      "referenceName": "System.Id",
      "name": "ID",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Id"
    },
    {
      "referenceName": "System.Title",
      "name": "Title",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Title"
    },
    {
      "referenceName": "System.State",
      "name": "State",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
    }
  ],
  "sortColumns": [
    {
      "field": {
        "referenceName": "Microsoft.VSTS.Common.Priority",
        "name": "Priority",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.Priority"
      },
      "descending": false
    },
    {
      "field": {
        "referenceName": "System.CreatedDate",
        "name": "Created Date",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.CreatedDate"
      },
      "descending": true
    }
  ],
  "wiql": "select [System.Id], [System.Title], [System.State] from WorkItems where [System.WorkItemType] = 'Bug' and [System.State] = 'Active' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc",
  "isPublic": true,
  "clauses": {
    "logicalOperator": "and",
    "clauses": [
      {
        "field": {
          "referenceName": "System.WorkItemType",
          "name": "Work Item Type",
          "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.WorkItemType"
        },
        "operator": {
          "referenceName": "SupportedOperations.Equals",
          "name": "="
        },
        "value": "Bug"
      },
      {
        "field": {
          "referenceName": "System.State",
          "name": "State",
          "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
        },
        "operator": {
          "referenceName": "SupportedOperations.Equals",
          "name": "="
        },
        "value": "Active"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/qr.aspx?pguid=6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c&qid=342f0f44-4069-46b1-a940-3d0468979ceb"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/8a8c8212-15ca-41ed-97aa-1d6fbfbcd581"
    },
    "wiql": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/wiql/342f0f44-4069-46b1-a940-3d0468979ceb"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/queries/342f0f44-4069-46b1-a940-3d0468979ceb"
}

Definice

Name	Description
IdentityReference	Popisuje odkaz na identitu.
LinkQueryMode	Režim dotazu odkazu.
LogicalOperation	Logický operátor oddělující klauzuli podmínky
QueryHierarchyItem	Představuje položku v hierarchii dotazu pracovní položky. Může se jednat o dotaz nebo složku.
QueryRecursionOption	Možnost rekurze pro použití ve stromovém dotazu.
QueryType	Typ dotazu.
ReferenceLinks	Třída představující kolekci odkazů REST.
WorkItemFieldOperation	Popisuje operaci pole pracovní položky.
WorkItemFieldReference	Odkaz na pole v pracovní položce
WorkItemQueryClause	Představuje klauzuli v dotazu pracovní položky. Zobrazí se struktura dotazu na pracovní položku.
WorkItemQuerySortColumn	Sloupec řazení.

IdentityReference

Objekt

Popisuje odkaz na identitu.

Name	Typ	Description
_links	ReferenceLinks	Toto pole obsahuje nula nebo zajímavější odkazy na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto tématu grafu.
descriptor	string	Popisovač je primární způsob, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejné téma grafu v rámci účtů i organizací.
directoryAlias	string	Zastaralé – Je možné načíst dotazováním uživatele Graphu, na který odkazuje položka "self" slovníku IdentityRef "_links".
displayName	string	Toto je ne jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém zprostředkovateli.
id	string (uuid)
imageUrl	string	Zastaralé – k dispozici v položce avatar ve slovníku IdentityRef "_links"
inactive	boolean	Zastaralé – Lze načíst dotazem na stav členství v grafu odkazovaném v položce "membershipState" slovníku GraphUser "_links"
isAadIdentity	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Popisovač.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Popisovač.IsGroupType)
isDeletedInOrigin	boolean
name	string	Starší vlastnost back-compat. Toto byla hodnota specifická pro wit z konstant. Pokud cílí na nejnovější verzi, bude v klientovi skrytý (ale existuje).
profileUrl	string	Zastaralé – nepoužívá se ve většině existujících implementací ToIdentityRef
uniqueName	string	Zastaralé – místo toho použijte Domain+PrincipalName.
url	string	Tato adresa URL je úplná trasa ke zdrojovému prostředku tohoto předmětu grafu.

LinkQueryMode

Výčet

Režim dotazu odkazu.

Hodnota	Description
linksOneHopDoesNotContain	Vrátí pracovní položky, které vyhovují zdroji, pouze pokud žádná propojená pracovní položka nesplňuje kritéria propojení a cíle.
linksOneHopMayContain	Vrátí pracovní položky, které splňují kritéria zdroje a propojení, i když žádná propojená pracovní položka nesplňuje cílová kritéria.
linksOneHopMustContain	Vrátí pracovní položky, ve kterých jsou splněna kritéria zdroje, cíle a propojení.
linksRecursiveDoesNotContain
linksRecursiveMayContain	Vrátí pracovní položky hierarchii pracovních položek, které ve výchozím nastavení vyhovují zdroji.
linksRecursiveMustContain
workItems	Vrátí plochý seznam pracovních položek.

LogicalOperation

Výčet

Logický operátor oddělující klauzuli podmínky

Hodnota	Description
and
none
or

QueryHierarchyItem

Objekt

Představuje položku v hierarchii dotazu pracovní položky. Může se jednat o dotaz nebo složku.

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST
children	QueryHierarchyItem[]	Podřízené položky dotazu ve složce dotazu.
clauses	WorkItemQueryClause	Klauzule pro plochý dotaz.
columns	WorkItemFieldReference[]	Sloupce dotazu.
createdBy	IdentityReference	Identita, která vytvořila položku dotazu.
createdDate	string (date-time)	Po vytvoření položky dotazu
filterOptions	LinkQueryMode	Režim dotazu odkazu.
hasChildren	boolean	Pokud se jedná o složku dotazu, označuje, jestli obsahuje nějaké podřízené položky.
id	string (uuid)	ID položky dotazu.
isDeleted	boolean	Označuje, jestli je tato položka dotazu odstraněna. Nastavením této hodnoty na hodnotu false u odstraněné položky dotazu ji zrušíte. Zrušením zrušení dotazu nebo složky se nepřenesou zpět změny oprávnění, které se na něj dříve použily.
isFolder	boolean	Označuje, jestli se jedná o složku dotazu nebo dotaz.
isInvalidSyntax	boolean	Označuje, jestli je hodnota WIQL tohoto dotazu neplatná. Příčinou může být neplatná syntaxe nebo neplatná cesta k oblasti nebo iteraci.
isPublic	boolean	Označuje, jestli je tato položka dotazu veřejná nebo soukromá.
lastExecutedBy	IdentityReference	Identita, která dotaz naposledy spustila.
lastExecutedDate	string (date-time)	Kdy byl dotaz naposledy spuštěn.
lastModifiedBy	IdentityReference	Identita, která položku dotazu naposledy upravila.
lastModifiedDate	string (date-time)	Kdy byla položka dotazu naposledy změněna.
linkClauses	WorkItemQueryClause	Klauzule dotazu odkazu.
name	string	Název položky dotazu.
path	string	Cesta k položce dotazu.
queryRecursionOption	QueryRecursionOption	Možnost rekurze pro použití ve stromovém dotazu.
queryType	QueryType	Typ dotazu.
sortColumns	WorkItemQuerySortColumn[]	Sloupce řazení dotazu.
sourceClauses	WorkItemQueryClause	Zdrojové klauzule ve stromu nebo dotazu na propojení s jedním segmentem.
targetClauses	WorkItemQueryClause	Cílové klauzule ve stromu nebo dotazu na propojení s jedním segmentem.
url	string
wiql	string	Text WIQL dotazu

QueryRecursionOption

Výčet

Možnost rekurze pro použití ve stromovém dotazu.

Hodnota	Description
childFirst	Vrátí pracovní položky, které splňují cílová kritéria, i když žádná pracovní položka nesplňuje kritéria zdroje a propojení.
parentFirst	Vrátí pracovní položky, které vyhovují zdroji, i když žádná propojená pracovní položka nesplňuje kritéria cíle a propojení.

QueryType

Výčet

Typ dotazu.

Hodnota	Description
flat	Získá plochý seznam pracovních položek.
oneHop	Získá seznam pracovních položek a jejich přímých odkazů.
tree	Získá strom pracovních položek zobrazující jejich hierarchii propojení.

ReferenceLinks

Objekt

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Jen pro čtení odkazů. Vzhledem k tomu, že odkazy odkazy jsou jen pro čtení, chceme je zveřejnit jen pro čtení.

WorkItemFieldOperation

Objekt

Popisuje operaci pole pracovní položky.

Name	Typ	Description
name	string	Popisný název operace.
referenceName	string	Název odkazu operace.

WorkItemFieldReference

Objekt

Odkaz na pole v pracovní položce

Name	Typ	Description
name	string	Popisný název pole
referenceName	string	Název odkazu pole.
url	string	Adresa URL REST prostředku.

WorkItemQueryClause

Objekt

Představuje klauzuli v dotazu pracovní položky. Zobrazí se struktura dotazu na pracovní položku.

Name	Typ	Description
clauses	WorkItemQueryClause[]	Podřízené klauzule, pokud je aktuální klauzule logickým operátorem
field	WorkItemFieldReference	Pole přidružené k podmínce
fieldValue	WorkItemFieldReference	Pravá strana podmínky, když je pole s porovnáním polí
isFieldValue	boolean	Určuje, jestli se jedná o pole pro porovnání polí.
logicalOperator	LogicalOperation	Logický operátor oddělující klauzuli podmínky
operator	WorkItemFieldOperation	Operátor pole
value	string	Pravá strana podmínky, když je pole na porovnání hodnot

WorkItemQuerySortColumn

Objekt

Sloupec řazení.

Name	Typ	Description
descending	boolean	Směr řazení.
field	WorkItemFieldReference	Pole pracovní položky

Sdílet prostřednictvím

Queries - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

oauth2

Rozsahy

Příklady

Rename a folder

Ukázkový požadavek

Ukázková odpověď

Rename a query

Ukázkový požadavek

Ukázková odpověď

Undelete a query or folder

Ukázkový požadavek

Ukázková odpověď

Update a query

Ukázkový požadavek

Ukázková odpověď

Definice

IdentityReference

LinkQueryMode

LogicalOperation

QueryHierarchyItem

QueryRecursionOption

QueryType

ReferenceLinks

WorkItemFieldOperation

WorkItemFieldReference

WorkItemQueryClause

WorkItemQuerySortColumn

Další materiály