Fields - Update

Referenz

Dienst:: Work Item Tracking

API-Version:: 7.1

Aktualisieren eines Felds.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
fieldNameOrRefName	path	True	string	Name/Verweisname des zu aktualisierenden Felds
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path		string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
isDeleted	boolean	Gibt an, ob der Benutzer das Feld wiederherstellen möchte.
isLocked	boolean	Gibt an, ob der Benutzer das Feld sperren möchte.

Antworten

Name	Typ	Beschreibung
200 OK	WorkItemField2	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name	Beschreibung
vso.work_write	Gewährt die Möglichkeit, Arbeitsaufgaben und Abfragen zu lesen, zu erstellen und zu aktualisieren, Boardmetadaten zu aktualisieren, Bereiche und Iterationspfade für andere Pfade für die Nachverfolgung verwandter Arbeitsaufgaben zu aktualisieren, Abfragen auszuführen und Benachrichtigungen über Arbeitsaufgabenereignisse über Diensthaken zu erhalten.

Beispiele

Set field locked

Undelete a field

Set field locked

Beispielanforderung

HTTP

PATCH https://dev.azure.com/{organization}/_apis/wit/fields/{fieldNameOrRefName}?api-version=7.1

{
  "isLocked": true
}

Beispiel für eine Antwort

Statuscode:: 200

persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAAAMDzOy0XQtlQAAAAA=

{
  "name": "New Work Item Field3",
  "referenceName": "Custom.TestField",
  "description": "New work item field for testing",
  "type": "string",
  "usage": "workItem",
  "readOnly": false,
  "canSortBy": true,
  "isQueryable": true,
  "supportedOperations": [
    {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    {
      "referenceName": "SupportedOperations.NotEquals",
      "name": "<>"
    },
    {
      "referenceName": "SupportedOperations.GreaterThan",
      "name": ">"
    },
    {
      "referenceName": "SupportedOperations.LessThan",
      "name": "<"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEquals",
      "name": ">="
    },
    {
      "referenceName": "SupportedOperations.LessThanEquals",
      "name": "<="
    },
    {
      "referenceName": "SupportedOperations.Contains",
      "name": "Contains"
    },
    {
      "referenceName": "SupportedOperations.NotContains",
      "name": "Does Not Contain"
    },
    {
      "referenceName": "SupportedOperations.In",
      "name": "In"
    },
    {
      "name": "Not In"
    },
    {
      "referenceName": "SupportedOperations.InGroup",
      "name": "In Group"
    },
    {
      "referenceName": "SupportedOperations.NotInGroup",
      "name": "Not In Group"
    },
    {
      "referenceName": "SupportedOperations.Ever",
      "name": "Was Ever"
    },
    {
      "referenceName": "SupportedOperations.EqualsField",
      "name": "= [Field]"
    },
    {
      "referenceName": "SupportedOperations.NotEqualsField",
      "name": "<> [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanField",
      "name": "> [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanField",
      "name": "< [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEqualsField",
      "name": ">= [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanEqualsField",
      "name": "<= [Field]"
    }
  ],
  "isIdentity": false,
  "isPicklist": false,
  "isLocked": true,
  "isPicklistSuggested": false,
  "url": "http://localhost/DefaultCollection/_apis/wit/fields/Custom.TestField"
}

Undelete a field

Beispielanforderung

HTTP

PATCH https://dev.azure.com/{organization}/_apis/wit/fields/{fieldNameOrRefName}?api-version=7.1

{
  "isDeleted": false
}

Beispiel für eine Antwort

Statuscode:: 200

persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAAAMDzOy0XQtlQAAAAA=

{
  "name": "New Work Item Field3",
  "referenceName": "Custom.TestField",
  "description": "New work item field for testing",
  "type": "string",
  "usage": "workItem",
  "readOnly": false,
  "canSortBy": true,
  "isQueryable": true,
  "supportedOperations": [
    {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    {
      "referenceName": "SupportedOperations.NotEquals",
      "name": "<>"
    },
    {
      "referenceName": "SupportedOperations.GreaterThan",
      "name": ">"
    },
    {
      "referenceName": "SupportedOperations.LessThan",
      "name": "<"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEquals",
      "name": ">="
    },
    {
      "referenceName": "SupportedOperations.LessThanEquals",
      "name": "<="
    },
    {
      "referenceName": "SupportedOperations.Contains",
      "name": "Contains"
    },
    {
      "referenceName": "SupportedOperations.NotContains",
      "name": "Does Not Contain"
    },
    {
      "referenceName": "SupportedOperations.In",
      "name": "In"
    },
    {
      "name": "Not In"
    },
    {
      "referenceName": "SupportedOperations.InGroup",
      "name": "In Group"
    },
    {
      "referenceName": "SupportedOperations.NotInGroup",
      "name": "Not In Group"
    },
    {
      "referenceName": "SupportedOperations.Ever",
      "name": "Was Ever"
    },
    {
      "referenceName": "SupportedOperations.EqualsField",
      "name": "= [Field]"
    },
    {
      "referenceName": "SupportedOperations.NotEqualsField",
      "name": "<> [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanField",
      "name": "> [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanField",
      "name": "< [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEqualsField",
      "name": ">= [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanEqualsField",
      "name": "<= [Field]"
    }
  ],
  "isIdentity": false,
  "isPicklist": false,
  "isPicklistSuggested": false,
  "url": "http://localhost/DefaultCollection/_apis/wit/fields/Custom.TestField"
}

Definitionen

Name	Beschreibung
FieldType	Der Typ des Felds.
FieldUpdate	Beschreibt eine Aktualisierungsanforderung für ein Arbeitsaufgabenfeld.
FieldUsage	Die Verwendung des Felds.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
WorkItemField2	Beschreibt ein Feld für eine Arbeitsaufgabe und für diesen Arbeitsaufgabentyp spezifische Eigenschaften.
WorkItemFieldOperation	Beschreibt einen Arbeitsaufgabenfeldvorgang.

FieldType

Enumeration

Der Typ des Felds.

Wert	Beschreibung
boolean	Boolescher Feldtyp.
dateTime	Datetime-Feldtyp.
double	Doppelter Feldtyp.
guid	Guid-Feldtyp.
history	Typ des Verlaufsfelds.
html	HTML-Feldtyp (Multiline).
identity	Identitätsfeldtyp.
integer	Ganzzahliger Feldtyp.
picklistDouble	Doppelter Auswahlfeldtyp. Verwenden Sie beim Erstellen eines Doppeltauswahlfelds aus der REST-API "Double" FieldType.
picklistInteger	Feldtyp "Ganzzahlauswahlliste". Verwenden Sie beim Erstellen eines ganzzahligen Auswahllistenfelds aus der REST-API "Integer" FieldType.
picklistString	Zeichenfolgenauswahlfeldtyp. Verwenden Sie beim Erstellen eines Zeichenfolgenauswahlfelds aus der REST-API "String" FieldType.
plainText	Nur-Text-Feldtyp.
string	Zeichenfolgenfeldtyp.
treePath	Treepath-Feldtyp.

FieldUpdate

Objekt

Beschreibt eine Aktualisierungsanforderung für ein Arbeitsaufgabenfeld.

Name	Typ	Beschreibung
isDeleted	boolean	Gibt an, ob der Benutzer das Feld wiederherstellen möchte.
isLocked	boolean	Gibt an, ob der Benutzer das Feld sperren möchte.

FieldUsage

Enumeration

Die Verwendung des Felds.

Wert	Beschreibung
none	Leere Verwendung.
tree	Treenode-Feldverwendung.
workItem	Feldverwendung für Arbeitsaufgaben.
workItemLink	Feldverwendung für Arbeitsaufgabenlinks.
workItemTypeExtension	Verwendung der Arbeitsaufgabentyperweiterung.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

WorkItemField2

Objekt

Beschreibt ein Feld für eine Arbeitsaufgabe und für diesen Arbeitsaufgabentyp spezifische Eigenschaften.

Name	Typ	Beschreibung
_links	ReferenceLinks	Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
canSortBy	boolean	Gibt an, ob das Feld in Serverabfragen sortiert werden kann.
description	string	Die Beschreibung des Felds.
isDeleted	boolean	Gibt an, ob dieses Feld gelöscht wird.
isIdentity	boolean	Gibt an, ob es sich bei diesem Feld um ein Identitätsfeld handelt.
isLocked	boolean	Gibt an, ob dieses Feld zur Bearbeitung als gesperrt markiert ist.
isPicklist	boolean	Gibt an, ob diese Instanz die Auswahlliste ist.
isPicklistSuggested	boolean	Gibt an, ob es sich bei dieser Instanz um eine vorgeschlagene Auswahlliste handelt.
isQueryable	boolean	Gibt an, ob das Feld auf dem Server abgefragt werden kann.
name	string	Der Name des Felds.
picklistId	string (uuid)	Wenn es sich bei diesem Feld um die Auswahlliste handelt, ist der Bezeichner der zugeordneten Auswahlliste, andernfalls NULL
readOnly	boolean	Gibt an, ob das Feld [schreibgeschützt] ist.
referenceName	string	Der Verweisname des Felds.
supportedOperations	WorkItemFieldOperation[]	Die unterstützten Vorgänge in diesem Feld.
type	FieldType	Der Typ des Felds.
url	string
usage	FieldUsage	Die Verwendung des Felds.

WorkItemFieldOperation

Objekt

Beschreibt einen Arbeitsaufgabenfeldvorgang.

Name	Typ	Beschreibung
name	string	Anzeigename des Vorgangs.
referenceName	string	Verweisname des Vorgangs.

Freigeben über

Fields - Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Set field locked

Beispielanforderung

Beispiel für eine Antwort

Undelete a field

Beispielanforderung

Beispiel für eine Antwort

Definitionen

FieldType

FieldUpdate

FieldUsage

ReferenceLinks

WorkItemField2

WorkItemFieldOperation

Zusätzliche Ressourcen