Udostępnij za pośrednictwem


WorkItemTrackingRestClient class

Klasa podstawowa, która powinna być używana (pochodna) do tworzenia żądań do interfejsów API REST usługi VSS

Extends

Konstruktory

WorkItemTrackingRestClient(IVssRestClientOptions)

Właściwości

RESOURCE_AREA_ID

Metody

createAttachment(any, string, string, string, string)

Przekazuje załącznik.

createField(WorkItemField, string)

Utwórz nowe pole.

createOrUpdateClassificationNode(WorkItemClassificationNode, string, TreeStructureGroup, string)

Utwórz nowy lub zaktualizuj istniejący węzeł klasyfikacji.

createQuery(QueryHierarchyItem, string, string, boolean)

Tworzy zapytanie lub przenosi zapytanie.

createTemplate(WorkItemTemplate, string, string)

Tworzy szablon

createWorkItem(JsonPatchDocument, string, string, boolean, boolean, boolean, WorkItemExpand)

Tworzy pojedynczy element roboczy.

deleteClassificationNode(string, TreeStructureGroup, string, number)

Usuń istniejący węzeł klasyfikacji.

deleteField(string, string)

Usuwa pole. Aby cofnąć usunięcie pliku, zobacz interfejs API aktualizacji pola.

deleteQuery(string, string)

Usuń zapytanie lub folder. Spowoduje to usunięcie wszelkich zmian uprawnień w usuniętym zapytaniu lub folderze i dowolnym z jego elementów podrzędnych, jeśli jest to folder. Należy pamiętać, że nie można odzyskać usuniętych zmian uprawnień po undeleting kwerendy lub folderu.

deleteTemplate(string, string, string)

Usuwa szablon o podanym identyfikatorze

deleteWorkItem(number, string, boolean)

Usuwa określony element roboczy i wysyła go do Kosza, aby można go było przywrócić, jeśli jest to wymagane. Opcjonalnie, jeśli parametr destroy został ustawiony na wartość true, spowoduje trwałe zniszczenie elementu roboczego. OSTRZEŻENIE: Jeśli parametr destroy ma wartość true, elementy robocze usunięte przez to polecenie NIE będą przechodzić do kosza i nie ma możliwości ich przywrócenia/odzyskania po usunięciu. Nie zaleca się używania tego parametru. Jeśli to zrobisz, użyj tego parametru z wyjątkową ostrożnością.

destroyWorkItem(number, string)

Niszczy określony element roboczy trwale z Kosza. Tej akcji nie można cofnąć.

exportWorkItemTypeDefinition(string, string, boolean)

Eksportowanie typu elementu roboczego

getAccountMyWorkData(QueryOption)

TYLKO WEWNĘTRZNE: UŻYWANE PRZEZ KONTO MOJA STRONA SŁUŻBOWA. Spowoduje to zwrócenie szczegółów elementów roboczych Doing, Done, Follows i activity.

getAttachmentContent(string, string, string, boolean)

Pobiera załącznik.

getAttachmentZip(string, string, string, boolean)

Pobiera załącznik.

getClassificationNode(string, TreeStructureGroup, string, number)

Pobiera węzeł klasyfikacji dla danej ścieżki węzła.

getClassificationNodes(string, number[], number, ClassificationNodesErrorPolicy)

Pobiera główne węzły klasyfikacji lub listę węzłów klasyfikacji dla danej listy identyfikatorów węzłów dla danego projektu. W przypadku dostarczenia parametru ids uzyskasz listę węzłów klasyfikacji dla tych identyfikatorów. W przeciwnym razie uzyskasz główne węzły klasyfikacji dla tego projektu.

getComment(number, number, string)

Pobiera komentarz dla elementu roboczego w określonej wersji.

getComments(number, string, number, number, CommentSortOrder)

Pobiera określoną liczbę komentarzy dla elementu roboczego z określonej poprawki.

getDeletedWorkItem(number, string)

Pobiera usunięty element roboczy z Kosza.

getDeletedWorkItems(number[], string)

Pobiera elementy robocze z kosza, których identyfikatory zostały określone w parametrach

getDeletedWorkItemShallowReferences(string)

Pobiera listę identyfikatorów i adresów URL usuniętych elementów roboczych w Koszu.

getField(string, string)

Pobiera informacje o określonym polu.

getFields(string, GetFieldsExpand)

Zwraca informacje dla wszystkich pól. Parametr identyfikatora/nazwy projektu jest opcjonalny.

getQueries(string, QueryExpand, number, boolean)

Pobiera zapytania główne i ich dzieci

getQueriesBatch(QueryBatchGetRequest, string)

Pobiera listę zapytań według identyfikatorów (maksymalnie 1000)

getQuery(string, string, QueryExpand, number, boolean, boolean)

Pobiera pojedyncze zapytanie i jego elementy podrzędne

getQueryResultCount(string, string, string, boolean, number)

Pobiera wyniki zapytania przy użyciu identyfikatora zapytania.

getRecentActivityData()

Pobiera ostatnie działania elementów roboczych

getRecentMentions()

TYLKO WEWNĘTRZNE: UŻYWANE PRZEZ KONTO MOJA STRONA SŁUŻBOWA.

getRelationType(string)

Pobiera definicję typu relacji elementu roboczego.

getRelationTypes()

Pobiera typy relacji elementu roboczego.

getReportingLinksByLinkType(string, string[], string[], string, Date)

Pobieranie partii łączy elementów roboczych

getRevision(number, number, string, WorkItemExpand)

Zwraca w pełni nawodniony element roboczy dla żądanej poprawki

getRevisions(number, string, number, number, WorkItemExpand)

Zwraca listę w pełni nawodnionych poprawek elementów roboczych, stronicowanych.

getRootNodes(string, number)

Pobiera węzły klasyfikacji głównej w projekcie.

getTemplate(string, string, string)

Pobiera szablon o określonym identyfikatorze

getTemplates(string, string, string)

Pobiera szablon

getUpdate(number, number, string)

Zwraca pojedynczą aktualizację elementu roboczego

getUpdates(number, string, number, number)

Zwraca różnice między poprawkami elementów roboczych

getWorkArtifactLinkTypes()

Pobierz listę typów linków artefaktów wychodzących śledzenia elementów roboczych.

getWorkItem(number, string, string[], Date, WorkItemExpand)

Zwraca pojedynczy element roboczy.

getWorkItemIconJson(string, string, number)

Pobierz ikonę elementu roboczego z przyjazną nazwą i kolorem ikony.

getWorkItemIcons()

Pobierz listę wszystkich ikon elementów roboczych.

getWorkItemIconSvg(string, string, number)

Pobierz ikonę elementu roboczego z przyjazną nazwą i kolorem ikony.

getWorkItemIconXaml(string, string, number)

Pobierz ikonę elementu roboczego z przyjazną nazwą i kolorem ikony.

getWorkItemNextStatesOnCheckinAction(number[], string)

Zwraca następny stan na podanych identyfikatorach elementów roboczych.

getWorkItems(number[], string, string[], Date, WorkItemExpand, WorkItemErrorPolicy)

Zwraca listę elementów roboczych (maksymalnie 200)

getWorkItemsBatch(WorkItemBatchGetRequest, string)

Pobiera elementy robocze dla listy identyfikatorów elementów roboczych (maksymalnie 200)

getWorkItemStateColors(string[])

TYLKO WEWNĘTRZNE: Będzie on używany w przypadku środowiska służbowego mojego konta. Pobieranie koloru stanu typu elementu roboczego dla wielu projektów

getWorkItemTemplate(string, string, string, Date, WorkItemExpand)

Zwraca pojedynczy element roboczy z szablonu.

getWorkItemType(string, string)

Zwraca definicję typu elementu roboczego.

getWorkItemTypeCategories(string)

Pobierz wszystkie kategorie typów elementów roboczych.

getWorkItemTypeCategory(string, string)

Uzyskaj określoną kategorię typu elementu roboczego według nazwy.

getWorkItemTypeColorAndIcons(string[])

TYLKO WEWNĘTRZNE: Jest on używany dla dostawców kolorów i ikon. Pobieranie koloru typu wit dla wielu projektów

getWorkItemTypeColors(string[])

TYLKO WEWNĘTRZNE: Będzie on używany w przypadku środowiska służbowego mojego konta. Pobieranie koloru typu wit dla wielu projektów

getWorkItemTypeFieldsWithReferences(string, string, WorkItemTypeFieldsExpandLevel)

Pobierz listę pól dla typu elementu roboczego ze szczegółowymi odwołaniami.

getWorkItemTypeFieldWithReferences(string, string, string, WorkItemTypeFieldsExpandLevel)

Pobierz pole dla typu elementu roboczego ze szczegółowymi odwołaniami.

getWorkItemTypes(string)

Zwraca listę typów elementów roboczych

getWorkItemTypeStates(string, string)

Zwraca nazwy stanów i kolory dla typu elementu roboczego.

queryById(string, string, string, boolean, number)

Pobiera wyniki zapytania przy użyciu identyfikatora zapytania.

queryByWiql(Wiql, string, string, boolean, number)

Pobiera wyniki zapytania, biorąc pod uwagę jego WIQL.

queryWorkItemsForArtifactUris(ArtifactUriQuery, string)

Wysyła zapytania do elementów roboczych połączonych z daną listą identyfikatora URI artefaktu.

readReportingRevisionsGet(string, string[], string[], string, Date, boolean, boolean, boolean, boolean, ReportingRevisionsExpand, boolean, number)

Pobieranie partii poprawek elementów roboczych z opcją dołączania usuniętych elementów

readReportingRevisionsPost(ReportingWorkItemRevisionsFilter, string, string, Date, ReportingRevisionsExpand)

Pobierz partię poprawek elementów roboczych. To żądanie może być używane, jeśli lista pól jest wystarczająco duża, że może uruchomić adres URL przez limit długości.

replaceTemplate(WorkItemTemplate, string, string, string)

Zamień zawartość szablonu

restoreWorkItem(WorkItemDeleteUpdate, number, string)

Przywraca usunięty element roboczy z Kosza.

searchQueries(string, string, number, QueryExpand, boolean)

Wyszukuje wszystkie zapytania, do których użytkownik ma dostęp w bieżącym projekcie

sendMail(SendMailBody, string)

Metoda RESTful do wysyłania wiadomości e-mail dla wybranych/zapytanych elementów roboczych.

updateClassificationNode(WorkItemClassificationNode, string, TreeStructureGroup, string)

Zaktualizuj istniejący węzeł klasyfikacji.

updateField(UpdateWorkItemField, string, string)

Zaktualizuj pole.

updateQuery(QueryHierarchyItem, string, string, boolean)

Zaktualizuj zapytanie lub folder. Dzięki temu można aktualizować, zmieniać nazwy i przenosić zapytania i foldery.

updateWorkItem(JsonPatchDocument, number, string, boolean, boolean, boolean, WorkItemExpand)

Aktualizacje pojedynczy element roboczy.

updateWorkItemTypeDefinition(WorkItemTypeTemplateUpdateModel, string)

Dodawanie/aktualizowanie typu elementu roboczego

Szczegóły konstruktora

WorkItemTrackingRestClient(IVssRestClientOptions)

new WorkItemTrackingRestClient(options: IVssRestClientOptions)

Parametry

Szczegóły właściwości

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Wartość właściwości

string

Szczegóły metody

createAttachment(any, string, string, string, string)

Przekazuje załącznik.

function createAttachment(content: any, project?: string, fileName?: string, uploadType?: string, areaPath?: string): Promise<AttachmentReference>

Parametry

content

any

Zawartość do przekazania

project

string

Identyfikator projektu lub nazwa projektu

fileName

string

Nazwa pliku

uploadType

string

Typ przekazywania załącznika: prosty lub fragmentowany

areaPath

string

Docelowa ścieżka obszaru projektu

Zwraca

createField(WorkItemField, string)

Utwórz nowe pole.

function createField(workItemField: WorkItemField, project?: string): Promise<WorkItemField>

Parametry

workItemField
WorkItemField

Nowa definicja pola

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemField>

createOrUpdateClassificationNode(WorkItemClassificationNode, string, TreeStructureGroup, string)

Utwórz nowy lub zaktualizuj istniejący węzeł klasyfikacji.

function createOrUpdateClassificationNode(postedNode: WorkItemClassificationNode, project: string, structureGroup: TreeStructureGroup, path?: string): Promise<WorkItemClassificationNode>

Parametry

postedNode
WorkItemClassificationNode

Węzeł do utworzenia lub zaktualizowania.

project

string

Identyfikator projektu lub nazwa projektu

structureGroup
TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.

path

string

Ścieżka węzła klasyfikacji.

Zwraca

createQuery(QueryHierarchyItem, string, string, boolean)

Tworzy zapytanie lub przenosi zapytanie.

function createQuery(postedQuery: QueryHierarchyItem, project: string, query: string, validateWiqlOnly?: boolean): Promise<QueryHierarchyItem>

Parametry

postedQuery
QueryHierarchyItem

Zapytanie do utworzenia.

project

string

Identyfikator projektu lub nazwa projektu

query

string

Identyfikator lub ścieżka nadrzędna, w której ma zostać utworzone zapytanie.

validateWiqlOnly

boolean

Jeśli chcesz tylko zweryfikować zapytanie WIQL bez faktycznego utworzenia, ustaw je na true. Wartość domyślna to false.

Zwraca

createTemplate(WorkItemTemplate, string, string)

Tworzy szablon

function createTemplate(template: WorkItemTemplate, project: string, team: string): Promise<WorkItemTemplate>

Parametry

template
WorkItemTemplate

Zawartość szablonu

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

Zwraca

Promise<WorkItemTemplate>

createWorkItem(JsonPatchDocument, string, string, boolean, boolean, boolean, WorkItemExpand)

Tworzy pojedynczy element roboczy.

function createWorkItem(document: JsonPatchDocument, project: string, type: string, validateOnly?: boolean, bypassRules?: boolean, suppressNotifications?: boolean, expand?: WorkItemExpand): Promise<WorkItem>

Parametry

document
JsonPatchDocument

Dokument poprawki JSON reprezentujący element roboczy

project

string

Identyfikator projektu lub nazwa projektu

type

string

Typ elementu roboczego elementu roboczego do utworzenia

validateOnly

boolean

Wskaż, czy chcesz tylko zweryfikować zmiany bez zapisywania elementu roboczego

bypassRules

boolean

Nie wymuszaj reguł typów elementów roboczych w tej aktualizacji

suppressNotifications

boolean

Nie uruchamiaj żadnych powiadomień dotyczących tej zmiany

expand
WorkItemExpand

Parametry rozwijania atrybutów elementu roboczego. Możliwe opcje to { None, Relations, Fields, Links, All }.

Zwraca

Promise<WorkItem>

deleteClassificationNode(string, TreeStructureGroup, string, number)

Usuń istniejący węzeł klasyfikacji.

function deleteClassificationNode(project: string, structureGroup: TreeStructureGroup, path?: string, reclassifyId?: number): Promise<void>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

structureGroup
TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.

path

string

Ścieżka węzła klasyfikacji.

reclassifyId

number

Identyfikator docelowego węzła klasyfikacji na potrzeby ponownej klasyfikacji.

Zwraca

Promise<void>

deleteField(string, string)

Usuwa pole. Aby cofnąć usunięcie pliku, zobacz interfejs API aktualizacji pola.

function deleteField(fieldNameOrRefName: string, project?: string): Promise<void>

Parametry

fieldNameOrRefName

string

Prosta nazwa pola lub nazwa odwołania

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<void>

deleteQuery(string, string)

Usuń zapytanie lub folder. Spowoduje to usunięcie wszelkich zmian uprawnień w usuniętym zapytaniu lub folderze i dowolnym z jego elementów podrzędnych, jeśli jest to folder. Należy pamiętać, że nie można odzyskać usuniętych zmian uprawnień po undeleting kwerendy lub folderu.

function deleteQuery(project: string, query: string): Promise<void>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

query

string

Identyfikator lub ścieżka zapytania lub folderu do usunięcia.

Zwraca

Promise<void>

deleteTemplate(string, string, string)

Usuwa szablon o podanym identyfikatorze

function deleteTemplate(project: string, team: string, templateId: string): Promise<void>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

templateId

string

Identyfikator szablonu

Zwraca

Promise<void>

deleteWorkItem(number, string, boolean)

Usuwa określony element roboczy i wysyła go do Kosza, aby można go było przywrócić, jeśli jest to wymagane. Opcjonalnie, jeśli parametr destroy został ustawiony na wartość true, spowoduje trwałe zniszczenie elementu roboczego. OSTRZEŻENIE: Jeśli parametr destroy ma wartość true, elementy robocze usunięte przez to polecenie NIE będą przechodzić do kosza i nie ma możliwości ich przywrócenia/odzyskania po usunięciu. Nie zaleca się używania tego parametru. Jeśli to zrobisz, użyj tego parametru z wyjątkową ostrożnością.

function deleteWorkItem(id: number, project?: string, destroy?: boolean): Promise<WorkItemDelete>

Parametry

id

number

Identyfikator elementu roboczego do usunięcia

project

string

Identyfikator projektu lub nazwa projektu

destroy

boolean

Opcjonalny parametr, jeśli ma wartość true, element roboczy zostanie trwale usunięty. Uwaga: akcja niszczenia jest TRWAŁA i nie można jej cofnąć.

Zwraca

Promise<WorkItemDelete>

destroyWorkItem(number, string)

Niszczy określony element roboczy trwale z Kosza. Tej akcji nie można cofnąć.

function destroyWorkItem(id: number, project?: string): Promise<void>

Parametry

id

number

Identyfikator elementu roboczego, który ma zostać trwale zniszczony

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<void>

exportWorkItemTypeDefinition(string, string, boolean)

Eksportowanie typu elementu roboczego

function exportWorkItemTypeDefinition(project?: string, type?: string, exportGlobalLists?: boolean): Promise<WorkItemTypeTemplate>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

type

string

exportGlobalLists

boolean

Zwraca

getAccountMyWorkData(QueryOption)

TYLKO WEWNĘTRZNE: UŻYWANE PRZEZ KONTO MOJA STRONA SŁUŻBOWA. Spowoduje to zwrócenie szczegółów elementów roboczych Doing, Done, Follows i activity.

function getAccountMyWorkData(queryOption?: QueryOption): Promise<AccountMyWorkResult>

Parametry

queryOption
QueryOption

Zwraca

getAttachmentContent(string, string, string, boolean)

Pobiera załącznik.

function getAttachmentContent(id: string, project?: string, fileName?: string, download?: boolean): Promise<ArrayBuffer>

Parametry

id

string

Identyfikator załącznika

project

string

Identyfikator projektu lub nazwa projektu

fileName

string

Nazwa pliku

download

boolean

W przypadku ustawienia <wartości c>true</c> zawsze pobieraj załącznik

Zwraca

Promise<ArrayBuffer>

getAttachmentZip(string, string, string, boolean)

Pobiera załącznik.

function getAttachmentZip(id: string, project?: string, fileName?: string, download?: boolean): Promise<ArrayBuffer>

Parametry

id

string

Identyfikator załącznika

project

string

Identyfikator projektu lub nazwa projektu

fileName

string

Nazwa pliku

download

boolean

W przypadku ustawienia <wartości c>true</c> zawsze pobieraj załącznik

Zwraca

Promise<ArrayBuffer>

getClassificationNode(string, TreeStructureGroup, string, number)

Pobiera węzeł klasyfikacji dla danej ścieżki węzła.

function getClassificationNode(project: string, structureGroup: TreeStructureGroup, path?: string, depth?: number): Promise<WorkItemClassificationNode>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

structureGroup
TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.

path

string

Ścieżka węzła klasyfikacji.

depth

number

Głębokość dzieci do pobrania.

Zwraca

getClassificationNodes(string, number[], number, ClassificationNodesErrorPolicy)

Pobiera główne węzły klasyfikacji lub listę węzłów klasyfikacji dla danej listy identyfikatorów węzłów dla danego projektu. W przypadku dostarczenia parametru ids uzyskasz listę węzłów klasyfikacji dla tych identyfikatorów. W przeciwnym razie uzyskasz główne węzły klasyfikacji dla tego projektu.

function getClassificationNodes(project: string, ids: number[], depth?: number, errorPolicy?: ClassificationNodesErrorPolicy): Promise<WorkItemClassificationNode[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

ids

number[]

Identyfikatory węzłów klasyfikacji liczb całkowitych rozdzielonych przecinkami. Nie jest to wymagane, jeśli chcesz mieć węzły główne.

depth

number

Głębokość dzieci do pobrania.

errorPolicy
ClassificationNodesErrorPolicy

Flaga do obsługi błędów podczas pobierania niektórych węzłów. Możliwe opcje to Niepowodzenie i Pominięcie.

Zwraca

getComment(number, number, string)

Pobiera komentarz dla elementu roboczego w określonej wersji.

function getComment(id: number, revision: number, project?: string): Promise<WorkItemComment>

Parametry

id

number

Identyfikator elementu roboczego

revision

number

Poprawka, dla której należy pobrać komentarz

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemComment>

getComments(number, string, number, number, CommentSortOrder)

Pobiera określoną liczbę komentarzy dla elementu roboczego z określonej poprawki.

function getComments(id: number, project?: string, fromRevision?: number, top?: number, order?: CommentSortOrder): Promise<WorkItemComments>

Parametry

id

number

Identyfikator elementu roboczego

project

string

Identyfikator projektu lub nazwa projektu

fromRevision

number

Poprawka, z której mają być pobierane komentarze (wartość domyślna to 1)

top

number

Liczba komentarzy do zwrócenia (wartość domyślna to 200)

order
CommentSortOrder

Rosnąco lub malejąco według identyfikatora poprawki (wartość domyślna to rosnąco)

Zwraca

Promise<WorkItemComments>

getDeletedWorkItem(number, string)

Pobiera usunięty element roboczy z Kosza.

function getDeletedWorkItem(id: number, project?: string): Promise<WorkItemDelete>

Parametry

id

number

Identyfikator elementu roboczego, który ma zostać zwrócony

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemDelete>

getDeletedWorkItems(number[], string)

Pobiera elementy robocze z kosza, których identyfikatory zostały określone w parametrach

function getDeletedWorkItems(ids: number[], project?: string): Promise<WorkItemDeleteReference[]>

Parametry

ids

number[]

Rozdzielona przecinkami lista identyfikatorów usuniętych elementów roboczych do zwrócenia

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

getDeletedWorkItemShallowReferences(string)

Pobiera listę identyfikatorów i adresów URL usuniętych elementów roboczych w Koszu.

function getDeletedWorkItemShallowReferences(project?: string): Promise<WorkItemDeleteShallowReference[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

getField(string, string)

Pobiera informacje o określonym polu.

function getField(fieldNameOrRefName: string, project?: string): Promise<WorkItemField>

Parametry

fieldNameOrRefName

string

Prosta nazwa pola lub nazwa odwołania

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemField>

getFields(string, GetFieldsExpand)

Zwraca informacje dla wszystkich pól. Parametr identyfikatora/nazwy projektu jest opcjonalny.

function getFields(project?: string, expand?: GetFieldsExpand): Promise<WorkItemField[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

expand
GetFieldsExpand

Użyj pól rozszerzeń, aby uwzględnić pola rozszerzeń, w przeciwnym razie je wykluczyć. Chyba że flaga funkcji dla tego parametru jest włączona, pola rozszerzenia są zawsze uwzględniane.

Zwraca

Promise<WorkItemField[]>

getQueries(string, QueryExpand, number, boolean)

Pobiera zapytania główne i ich dzieci

function getQueries(project: string, expand?: QueryExpand, depth?: number, includeDeleted?: boolean): Promise<QueryHierarchyItem[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

expand
QueryExpand

Uwzględnij ciąg zapytania (wiql), klauzule, kolumny wyników zapytania i opcje sortowania w wynikach.

depth

number

W folderze zapytań zwróć zapytania podrzędne i foldery do tej głębokości.

includeDeleted

boolean

Dołączanie usuniętych zapytań i folderów

Zwraca

Promise<QueryHierarchyItem[]>

getQueriesBatch(QueryBatchGetRequest, string)

Pobiera listę zapytań według identyfikatorów (maksymalnie 1000)

function getQueriesBatch(queryGetRequest: QueryBatchGetRequest, project: string): Promise<QueryHierarchyItem[]>

Parametry

queryGetRequest
QueryBatchGetRequest
project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<QueryHierarchyItem[]>

getQuery(string, string, QueryExpand, number, boolean, boolean)

Pobiera pojedyncze zapytanie i jego elementy podrzędne

function getQuery(project: string, query: string, expand?: QueryExpand, depth?: number, includeDeleted?: boolean, useIsoDateFormat?: boolean): Promise<QueryHierarchyItem>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

query

string

Identyfikator lub ścieżka zapytania.

expand
QueryExpand

Uwzględnij ciąg zapytania (wiql), klauzule, kolumny wyników zapytania i opcje sortowania w wynikach.

depth

number

W folderze zapytań zwróć zapytania podrzędne i foldery do tej głębokości.

includeDeleted

boolean

Dołączanie usuniętych zapytań i folderów

useIsoDateFormat

boolean

Klauzule zapytania Typu data/godzina będą formatowane przy użyciu zgodnego formatu ISO 8601

Zwraca

getQueryResultCount(string, string, string, boolean, number)

Pobiera wyniki zapytania przy użyciu identyfikatora zapytania.

function getQueryResultCount(id: string, project?: string, team?: string, timePrecision?: boolean, top?: number): Promise<number>

Parametry

id

string

Identyfikator zapytania.

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

timePrecision

boolean

Niezależnie od tego, czy należy używać precyzji czasu.

top

number

Maksymalna liczba wyników do zwrócenia.

Zwraca

Promise<number>

getRecentActivityData()

Pobiera ostatnie działania elementów roboczych

function getRecentActivityData(): Promise<AccountRecentActivityWorkItemModel2[]>

Zwraca

getRecentMentions()

TYLKO WEWNĘTRZNE: UŻYWANE PRZEZ KONTO MOJA STRONA SŁUŻBOWA.

function getRecentMentions(): Promise<AccountRecentMentionWorkItemModel[]>

Zwraca

getRelationType(string)

Pobiera definicję typu relacji elementu roboczego.

function getRelationType(relation: string): Promise<WorkItemRelationType>

Parametry

relation

string

Nazwa relacji

Zwraca

getRelationTypes()

Pobiera typy relacji elementu roboczego.

function getRelationTypes(): Promise<WorkItemRelationType[]>

Zwraca

getReportingLinksByLinkType(string, string[], string[], string, Date)

Pobieranie partii łączy elementów roboczych

function getReportingLinksByLinkType(project?: string, linkTypes?: string[], types?: string[], continuationToken?: string, startDateTime?: Date): Promise<ReportingWorkItemLinksBatch>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

linkTypes

string[]

Lista typów do filtrowania wyników do określonych typów linków. Pomiń ten parametr, aby uzyskać łącza elementów roboczych wszystkich typów linków.

types

string[]

Lista typów do filtrowania wyników do określonych typów elementów roboczych. Pomiń ten parametr, aby uzyskać linki elementów roboczych wszystkich typów elementów roboczych.

continuationToken

string

Określa kontynuacjęToken, aby uruchomić partię z. Pomiń ten parametr, aby uzyskać pierwszą partię łączy.

startDateTime

Date

Data/godzina, która ma być używana jako punkt wyjścia dla zmian linków. Zostaną zwrócone tylko zmiany łącza, które wystąpiły po tej dacie/godzinie. Nie można użyć w połączeniu z parametrem "znak wodny".

Zwraca

getRevision(number, number, string, WorkItemExpand)

Zwraca w pełni nawodniony element roboczy dla żądanej poprawki

function getRevision(id: number, revisionNumber: number, project?: string, expand?: WorkItemExpand): Promise<WorkItem>

Parametry

id

number

revisionNumber

number

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItem>

getRevisions(number, string, number, number, WorkItemExpand)

Zwraca listę w pełni nawodnionych poprawek elementów roboczych, stronicowanych.

function getRevisions(id: number, project?: string, top?: number, skip?: number, expand?: WorkItemExpand): Promise<WorkItem[]>

Parametry

id

number

project

string

Identyfikator projektu lub nazwa projektu

top

number

skip

number

Zwraca

Promise<WorkItem[]>

getRootNodes(string, number)

Pobiera węzły klasyfikacji głównej w projekcie.

function getRootNodes(project: string, depth?: number): Promise<WorkItemClassificationNode[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

depth

number

Głębokość dzieci do pobrania.

Zwraca

getTemplate(string, string, string)

Pobiera szablon o określonym identyfikatorze

function getTemplate(project: string, team: string, templateId: string): Promise<WorkItemTemplate>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

templateId

string

Identyfikator szablonu

Zwraca

Promise<WorkItemTemplate>

getTemplates(string, string, string)

Pobiera szablon

function getTemplates(project: string, team: string, workitemtypename?: string): Promise<WorkItemTemplateReference[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

workitemtypename

string

Opcjonalnie, Po określeniu zwraca szablony dla danego typu elementu roboczego.

Zwraca

getUpdate(number, number, string)

Zwraca pojedynczą aktualizację elementu roboczego

function getUpdate(id: number, updateNumber: number, project?: string): Promise<WorkItemUpdate>

Parametry

id

number

updateNumber

number

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemUpdate>

getUpdates(number, string, number, number)

Zwraca różnice między poprawkami elementów roboczych

function getUpdates(id: number, project?: string, top?: number, skip?: number): Promise<WorkItemUpdate[]>

Parametry

id

number

project

string

Identyfikator projektu lub nazwa projektu

top

number

skip

number

Zwraca

Promise<WorkItemUpdate[]>

getWorkArtifactLinkTypes()

Pobierz listę typów linków artefaktów wychodzących śledzenia elementów roboczych.

function getWorkArtifactLinkTypes(): Promise<WorkArtifactLink[]>

Zwraca

Promise<WorkArtifactLink[]>

getWorkItem(number, string, string[], Date, WorkItemExpand)

Zwraca pojedynczy element roboczy.

function getWorkItem(id: number, project?: string, fields?: string[], asOf?: Date, expand?: WorkItemExpand): Promise<WorkItem>

Parametry

id

number

Identyfikator elementu roboczego

project

string

Identyfikator projektu lub nazwa projektu

fields

string[]

Rozdzielona przecinkami lista żądanych pól

asOf

Date

AsOf UTC ciąg daty i godziny

expand
WorkItemExpand

Parametry rozwijania atrybutów elementów roboczych. Możliwe opcje to { None, Relations, Fields, Links, All }.

Zwraca

Promise<WorkItem>

getWorkItemIconJson(string, string, number)

Pobierz ikonę elementu roboczego z przyjazną nazwą i kolorem ikony.

function getWorkItemIconJson(icon: string, color?: string, v?: number): Promise<WorkItemIcon>

Parametry

icon

string

Nazwa ikony

color

string

6-cyfrowy kolor szesnastkowy ikony

v

number

Wersja ikony (używana tylko do unieważnienia pamięci podręcznej)

Zwraca

Promise<WorkItemIcon>

getWorkItemIcons()

Pobierz listę wszystkich ikon elementów roboczych.

function getWorkItemIcons(): Promise<WorkItemIcon[]>

Zwraca

Promise<WorkItemIcon[]>

getWorkItemIconSvg(string, string, number)

Pobierz ikonę elementu roboczego z przyjazną nazwą i kolorem ikony.

function getWorkItemIconSvg(icon: string, color?: string, v?: number): Promise<any>

Parametry

icon

string

Nazwa ikony

color

string

6-cyfrowy kolor szesnastkowy ikony

v

number

Wersja ikony (używana tylko do unieważnienia pamięci podręcznej)

Zwraca

Promise<any>

getWorkItemIconXaml(string, string, number)

Pobierz ikonę elementu roboczego z przyjazną nazwą i kolorem ikony.

function getWorkItemIconXaml(icon: string, color?: string, v?: number): Promise<any>

Parametry

icon

string

Nazwa ikony

color

string

6-cyfrowy kolor szesnastkowy ikony

v

number

Wersja ikony (używana tylko do unieważnienia pamięci podręcznej)

Zwraca

Promise<any>

getWorkItemNextStatesOnCheckinAction(number[], string)

Zwraca następny stan na podanych identyfikatorach elementów roboczych.

function getWorkItemNextStatesOnCheckinAction(ids: number[], action?: string): Promise<WorkItemNextStateOnTransition[]>

Parametry

ids

number[]

lista identyfikatorów elementów roboczych

action

string

możliwe akcje. Obecnie obsługuje tylko ewidencjonu

Zwraca

getWorkItems(number[], string, string[], Date, WorkItemExpand, WorkItemErrorPolicy)

Zwraca listę elementów roboczych (maksymalnie 200)

function getWorkItems(ids: number[], project?: string, fields?: string[], asOf?: Date, expand?: WorkItemExpand, errorPolicy?: WorkItemErrorPolicy): Promise<WorkItem[]>

Parametry

ids

number[]

Rozdzielona przecinkami lista żądanych identyfikatorów elementów roboczych. (Dozwolone są maksymalnie 200 identyfikatorów).

project

string

Identyfikator projektu lub nazwa projektu

fields

string[]

Rozdzielona przecinkami lista żądanych pól

asOf

Date

AsOf UTC ciąg daty i godziny

expand
WorkItemExpand

Parametry rozwijania atrybutów elementów roboczych. Możliwe opcje to { None, Relations, Fields, Links, All }.

errorPolicy
WorkItemErrorPolicy

Flaga do kontrolowania zasad błędów w zbiorczym żądaniu elementów roboczych. Możliwe opcje to {Fail, Omit}.

Zwraca

Promise<WorkItem[]>

getWorkItemsBatch(WorkItemBatchGetRequest, string)

Pobiera elementy robocze dla listy identyfikatorów elementów roboczych (maksymalnie 200)

function getWorkItemsBatch(workItemGetRequest: WorkItemBatchGetRequest, project?: string): Promise<WorkItem[]>

Parametry

workItemGetRequest
WorkItemBatchGetRequest
project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItem[]>

getWorkItemStateColors(string[])

TYLKO WEWNĘTRZNE: Będzie on używany w przypadku środowiska służbowego mojego konta. Pobieranie koloru stanu typu elementu roboczego dla wielu projektów

function getWorkItemStateColors(projectNames: string[]): Promise<ProjectWorkItemStateColors[]>

Parametry

projectNames

string[]

Zwraca

getWorkItemTemplate(string, string, string, Date, WorkItemExpand)

Zwraca pojedynczy element roboczy z szablonu.

function getWorkItemTemplate(project: string, type: string, fields?: string, asOf?: Date, expand?: WorkItemExpand): Promise<WorkItem>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

type

string

Nazwa typu elementu roboczego

fields

string

Rozdzielona przecinkami lista żądanych pól

asOf

Date

AsOf UTC ciąg daty i godziny

expand
WorkItemExpand

Parametry rozwijania atrybutów elementów roboczych. Możliwe opcje to { None, Relations, Fields, Links, All }.

Zwraca

Promise<WorkItem>

getWorkItemType(string, string)

Zwraca definicję typu elementu roboczego.

function getWorkItemType(project: string, type: string): Promise<WorkItemType>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

type

string

Nazwa typu elementu roboczego

Zwraca

Promise<WorkItemType>

getWorkItemTypeCategories(string)

Pobierz wszystkie kategorie typów elementów roboczych.

function getWorkItemTypeCategories(project: string): Promise<WorkItemTypeCategory[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

getWorkItemTypeCategory(string, string)

Uzyskaj określoną kategorię typu elementu roboczego według nazwy.

function getWorkItemTypeCategory(project: string, category: string): Promise<WorkItemTypeCategory>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

category

string

Nazwa kategorii

Zwraca

getWorkItemTypeColorAndIcons(string[])

TYLKO WEWNĘTRZNE: Jest on używany dla dostawców kolorów i ikon. Pobieranie koloru typu wit dla wielu projektów

function getWorkItemTypeColorAndIcons(projectNames: string[]): Promise<{ key: string, value: WorkItemTypeColorAndIcon[] }[]>

Parametry

projectNames

string[]

Zwraca

Promise<{ key: string, value: WorkItemTypeColorAndIcon[] }[]>

getWorkItemTypeColors(string[])

TYLKO WEWNĘTRZNE: Będzie on używany w przypadku środowiska służbowego mojego konta. Pobieranie koloru typu wit dla wielu projektów

function getWorkItemTypeColors(projectNames: string[]): Promise<{ key: string, value: WorkItemTypeColor[] }[]>

Parametry

projectNames

string[]

Zwraca

Promise<{ key: string, value: WorkItemTypeColor[] }[]>

getWorkItemTypeFieldsWithReferences(string, string, WorkItemTypeFieldsExpandLevel)

Pobierz listę pól dla typu elementu roboczego ze szczegółowymi odwołaniami.

function getWorkItemTypeFieldsWithReferences(project: string, type: string, expand?: WorkItemTypeFieldsExpandLevel): Promise<WorkItemTypeFieldWithReferences[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

type

string

Typ elementu roboczego.

expand
WorkItemTypeFieldsExpandLevel

Rozwiń poziom odpowiedzi interfejsu API. Właściwości: aby uwzględnić dozwolone wartości, wartość domyślną, isRequired itp. jako część odpowiedzi; Brak: aby pominąć te właściwości.

Zwraca

getWorkItemTypeFieldWithReferences(string, string, string, WorkItemTypeFieldsExpandLevel)

Pobierz pole dla typu elementu roboczego ze szczegółowymi odwołaniami.

function getWorkItemTypeFieldWithReferences(project: string, type: string, field: string, expand?: WorkItemTypeFieldsExpandLevel): Promise<WorkItemTypeFieldWithReferences>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

type

string

Typ elementu roboczego.

field

string

expand
WorkItemTypeFieldsExpandLevel

Rozwiń poziom odpowiedzi interfejsu API. Właściwości: aby uwzględnić dozwolone wartości, wartość domyślną, isRequired itp. jako część odpowiedzi; Brak: aby pominąć te właściwości.

Zwraca

getWorkItemTypes(string)

Zwraca listę typów elementów roboczych

function getWorkItemTypes(project: string): Promise<WorkItemType[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemType[]>

getWorkItemTypeStates(string, string)

Zwraca nazwy stanów i kolory dla typu elementu roboczego.

function getWorkItemTypeStates(project: string, type: string): Promise<WorkItemStateColor[]>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

type

string

Nazwa stanu

Zwraca

Promise<WorkItemStateColor[]>

queryById(string, string, string, boolean, number)

Pobiera wyniki zapytania przy użyciu identyfikatora zapytania.

function queryById(id: string, project?: string, team?: string, timePrecision?: boolean, top?: number): Promise<WorkItemQueryResult>

Parametry

id

string

Identyfikator zapytania.

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

timePrecision

boolean

Niezależnie od tego, czy należy używać precyzji czasu.

top

number

Maksymalna liczba wyników do zwrócenia.

Zwraca

queryByWiql(Wiql, string, string, boolean, number)

Pobiera wyniki zapytania, biorąc pod uwagę jego WIQL.

function queryByWiql(wiql: Wiql, project?: string, team?: string, timePrecision?: boolean, top?: number): Promise<WorkItemQueryResult>

Parametry

wiql
Wiql

Zapytanie zawierające WIQL.

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

timePrecision

boolean

Niezależnie od tego, czy należy używać precyzji czasu.

top

number

Maksymalna liczba wyników do zwrócenia.

Zwraca

queryWorkItemsForArtifactUris(ArtifactUriQuery, string)

Wysyła zapytania do elementów roboczych połączonych z daną listą identyfikatora URI artefaktu.

function queryWorkItemsForArtifactUris(artifactUriQuery: ArtifactUriQuery, project?: string): Promise<ArtifactUriQueryResult>

Parametry

artifactUriQuery
ArtifactUriQuery

Definiuje listę identyfikatorów URI artefaktów na potrzeby wykonywania zapytań dotyczących elementów roboczych.

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

readReportingRevisionsGet(string, string[], string[], string, Date, boolean, boolean, boolean, boolean, ReportingRevisionsExpand, boolean, number)

Pobieranie partii poprawek elementów roboczych z opcją dołączania usuniętych elementów

function readReportingRevisionsGet(project?: string, fields?: string[], types?: string[], continuationToken?: string, startDateTime?: Date, includeIdentityRef?: boolean, includeDeleted?: boolean, includeTagRef?: boolean, includeLatestOnly?: boolean, expand?: ReportingRevisionsExpand, includeDiscussionChangesOnly?: boolean, maxPageSize?: number): Promise<ReportingWorkItemRevisionsBatch>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

fields

string[]

Lista pól, które mają być zwracane w poprawkach elementów roboczych. Pomiń ten parametr, aby uzyskać wszystkie pola z możliwością raportowania.

types

string[]

Lista typów do filtrowania wyników do określonych typów elementów roboczych. Pomiń ten parametr, aby uzyskać poprawki elementów roboczych wszystkich typów elementów roboczych.

continuationToken

string

Określa znak wodny do uruchomienia partii. Pomiń ten parametr, aby uzyskać pierwszą partię poprawek.

startDateTime

Date

Data/godzina, która ma być punktem wyjścia dla poprawek, wszystkie poprawki zostaną wykonane po tej dacie/godzinie. Nie można użyć w połączeniu z parametrem "znak wodny".

includeIdentityRef

boolean

Zwraca odwołanie do tożsamości zamiast wartości ciągu dla pól tożsamości.

includeDeleted

boolean

Określ, czy usunięty element ma zostać zwrócony.

includeTagRef

boolean

Określ, czy obiekty tagów powinny być zwracane dla pola System.Tags.

includeLatestOnly

boolean

Zwracaj tylko najnowsze wersje elementów roboczych, pomijając wszystkie poprawki historyczne

expand
ReportingRevisionsExpand

Zwraca wszystkie pola w poprawkach elementów roboczych, w tym długie pola tekstowe, które nie są domyślnie zwracane

includeDiscussionChangesOnly

boolean

Zwracaj tylko te poprawki elementów roboczych, w których zmieniono tylko pole historii

maxPageSize

number

Maksymalna liczba wyników do zwrócenia w tej partii

Zwraca

readReportingRevisionsPost(ReportingWorkItemRevisionsFilter, string, string, Date, ReportingRevisionsExpand)

Pobierz partię poprawek elementów roboczych. To żądanie może być używane, jeśli lista pól jest wystarczająco duża, że może uruchomić adres URL przez limit długości.

function readReportingRevisionsPost(filter: ReportingWorkItemRevisionsFilter, project?: string, continuationToken?: string, startDateTime?: Date, expand?: ReportingRevisionsExpand): Promise<ReportingWorkItemRevisionsBatch>

Parametry

filter
ReportingWorkItemRevisionsFilter

Obiekt zawierający ustawienia żądania: filtr pola, filtr typu, format tożsamości

project

string

Identyfikator projektu lub nazwa projektu

continuationToken

string

Określa znak wodny do uruchomienia partii. Pomiń ten parametr, aby uzyskać pierwszą partię poprawek.

startDateTime

Date

Data/godzina, która ma być punktem wyjścia dla poprawek, wszystkie poprawki zostaną wykonane po tej dacie/godzinie. Nie można użyć w połączeniu z parametrem "znak wodny".

Zwraca

replaceTemplate(WorkItemTemplate, string, string, string)

Zamień zawartość szablonu

function replaceTemplate(templateContent: WorkItemTemplate, project: string, team: string, templateId: string): Promise<WorkItemTemplate>

Parametry

templateContent
WorkItemTemplate

Zawartość szablonu do zamiany na

project

string

Identyfikator projektu lub nazwa projektu

team

string

Identyfikator zespołu lub nazwa zespołu

templateId

string

Identyfikator szablonu

Zwraca

Promise<WorkItemTemplate>

restoreWorkItem(WorkItemDeleteUpdate, number, string)

Przywraca usunięty element roboczy z Kosza.

function restoreWorkItem(payload: WorkItemDeleteUpdate, id: number, project?: string): Promise<WorkItemDelete>

Parametry

payload
WorkItemDeleteUpdate

Paylod z instrukcjami aktualizowania flagi IsDeleted na false

id

number

Identyfikator elementu roboczego do przywrócenia

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemDelete>

searchQueries(string, string, number, QueryExpand, boolean)

Wyszukuje wszystkie zapytania, do których użytkownik ma dostęp w bieżącym projekcie

function searchQueries(project: string, filter: string, top?: number, expand?: QueryExpand, includeDeleted?: boolean): Promise<QueryHierarchyItemsResult>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

filter

string

Tekst do filtrowania zapytań za pomocą.

top

number

Liczba zwracanych zapytań (wartość domyślna to 50, a maksymalna to 200).

expand
QueryExpand
includeDeleted

boolean

Dołączanie usuniętych zapytań i folderów

Zwraca

sendMail(SendMailBody, string)

Metoda RESTful do wysyłania wiadomości e-mail dla wybranych/zapytanych elementów roboczych.

function sendMail(body: SendMailBody, project?: string): Promise<void>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<void>

updateClassificationNode(WorkItemClassificationNode, string, TreeStructureGroup, string)

Zaktualizuj istniejący węzeł klasyfikacji.

function updateClassificationNode(postedNode: WorkItemClassificationNode, project: string, structureGroup: TreeStructureGroup, path?: string): Promise<WorkItemClassificationNode>

Parametry

postedNode
WorkItemClassificationNode

Węzeł do utworzenia lub zaktualizowania.

project

string

Identyfikator projektu lub nazwa projektu

structureGroup
TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.

path

string

Ścieżka węzła klasyfikacji.

Zwraca

updateField(UpdateWorkItemField, string, string)

Zaktualizuj pole.

function updateField(payload: UpdateWorkItemField, fieldNameOrRefName: string, project?: string): Promise<WorkItemField>

Parametry

payload
UpdateWorkItemField

Payload zawiera żądaną wartość właściwości pola

fieldNameOrRefName

string

Nazwa/nazwa odwołania pola do zaktualizowania

project

string

Identyfikator projektu lub nazwa projektu

Zwraca

Promise<WorkItemField>

updateQuery(QueryHierarchyItem, string, string, boolean)

Zaktualizuj zapytanie lub folder. Dzięki temu można aktualizować, zmieniać nazwy i przenosić zapytania i foldery.

function updateQuery(queryUpdate: QueryHierarchyItem, project: string, query: string, undeleteDescendants?: boolean): Promise<QueryHierarchyItem>

Parametry

queryUpdate
QueryHierarchyItem

Zapytanie do aktualizacji.

project

string

Identyfikator projektu lub nazwa projektu

query

string

Identyfikator lub ścieżka zapytania do aktualizacji.

undeleteDescendants

boolean

Cofanie elementów podrzędnych tego folderu. Należy pamiętać, że nie spowoduje to przywrócenia zmian uprawnień, które zostały wcześniej zastosowane do elementów podrzędnych.

Zwraca

updateWorkItem(JsonPatchDocument, number, string, boolean, boolean, boolean, WorkItemExpand)

Aktualizacje pojedynczy element roboczy.

function updateWorkItem(document: JsonPatchDocument, id: number, project?: string, validateOnly?: boolean, bypassRules?: boolean, suppressNotifications?: boolean, expand?: WorkItemExpand): Promise<WorkItem>

Parametry

document
JsonPatchDocument

Dokument poprawki JSON reprezentujący aktualizację

id

number

Identyfikator elementu roboczego do zaktualizowania

project

string

Identyfikator projektu lub nazwa projektu

validateOnly

boolean

Określ, czy chcesz tylko zweryfikować zmiany bez zapisywania elementu roboczego

bypassRules

boolean

Nie wymuszaj reguł typów elementów roboczych w tej aktualizacji

suppressNotifications

boolean

Nie uruchamiaj żadnych powiadomień dotyczących tej zmiany

expand
WorkItemExpand

Parametry rozwijania atrybutów elementów roboczych. Możliwe opcje to { None, Relations, Fields, Links, All }.

Zwraca

Promise<WorkItem>

updateWorkItemTypeDefinition(WorkItemTypeTemplateUpdateModel, string)

Dodawanie/aktualizowanie typu elementu roboczego

function updateWorkItemTypeDefinition(updateModel: WorkItemTypeTemplateUpdateModel, project?: string): Promise<ProvisioningResult>

Parametry

project

string

Identyfikator projektu lub nazwa projektu

Zwraca