Freigeben über


TfvcRestClient class

Basisklasse, die verwendet (von abgeleitet) werden soll, um Anforderungen an VSS-REST-APIs zu senden

Extends

Konstruktoren

TfvcRestClient(IVssRestClientOptions)

Eigenschaften

RESOURCE_AREA_ID

Methoden

createChangeset(TfvcChangeset, string)

Erstellen Sie ein neues Changeset.

getBatchedChangesets(TfvcChangesetsRequestData)

Gibt Changesets für eine bestimmte Liste von Changeset-IDs zurück.

getBranch(string, string, boolean, boolean)

Rufen Sie eine einzelne Verzweigungshierarchie am angegebenen Pfad mit den angegebenen übergeordneten oder untergeordneten Elementen ab.

getBranches(string, boolean, boolean, boolean, boolean)

Rufen Sie eine Auflistung von Verzweigungsstammen ab– untergeordnete Elemente der ersten Ebene, Verzweigungen ohne Eltern.

getBranchRefs(string, string, boolean, boolean)

Abrufen von Branchhierarchien unterhalb des angegebenen scopePath

getChangeset(number, string, number, boolean, boolean, number, boolean, number, number, string, TfvcChangesetSearchCriteria)

Abrufen eines Tfvc-Changesets

getChangesetChanges(number, number, number)

Rufen Sie Tfvc-Änderungen für ein bestimmtes Changeset ab.

getChangesets(string, number, number, number, string, TfvcChangesetSearchCriteria)

Abrufen von Tfvc Changesets

getChangesetWorkItems(number)

Ruft die Arbeitselemente ab, die einem bestimmten Changeset zugeordnet sind.

getItem(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

getItemContent(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

getItems(string, string, VersionControlRecursionType, boolean, TfvcVersionDescriptor)

Abrufen einer Liste von Tfvc-Elementen

getItemsBatch(TfvcItemRequestData, string)

Posten sie zum Abrufen einer Gruppe von Elementen, die eine Liste von Pfaden oder einen langen Pfad angegeben haben. Ermöglicht das Angeben der rekursionLevel- und Versionsdeskriptoren für jeden Pfad.

getItemsBatchZip(TfvcItemRequestData, string)

Posten sie zum Abrufen einer Gruppe von Elementen, die eine Liste von Pfaden oder einen langen Pfad angegeben haben. Ermöglicht das Angeben der rekursionLevel- und Versionsdeskriptoren für jeden Pfad.

getItemText(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

getItemZip(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

getLabel(string, TfvcLabelRequestData, string)

Rufen Sie eine einzelne deep-Bezeichnung ab.

getLabelItems(string, number, number)

Ruft Elemente unter einer Bezeichnung ab.

getLabels(TfvcLabelRequestData, string, number, number)

Rufen Sie eine Auflistung flacher Bezeichnungsverweise ab.

getShelveset(string, TfvcShelvesetRequestData)

Rufen Sie ein einzelnes deep shelveset ab.

getShelvesetChanges(string, number, number)

Abrufen von Änderungen, die in einem Shelveset enthalten sind.

getShelvesets(TfvcShelvesetRequestData, number, number)

Gibt eine Auflistung flacher Shelveset-Verweise zurück.

getShelvesetWorkItems(string)

Ruft Arbeitselemente ab, die einem Shelveset zugeordnet sind.

getTfvcStatistics(string, string)

Stellt die Dateianzahl und unkomprimierte Bytes für eine Sammlung/ein Projekt in einem bestimmten Bereich für TFVC bereit.

Details zum Konstruktor

TfvcRestClient(IVssRestClientOptions)

new TfvcRestClient(options: IVssRestClientOptions)

Parameter

Details zur Eigenschaft

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Eigenschaftswert

string

Details zur Methode

createChangeset(TfvcChangeset, string)

Erstellen Sie ein neues Changeset.

function createChangeset(changeset: TfvcChangeset, project?: string): Promise<TfvcChangesetRef>

Parameter

changeset
TfvcChangeset
project

string

Projekt-ID oder Projektname

Gibt zurück

Promise<TfvcChangesetRef>

getBatchedChangesets(TfvcChangesetsRequestData)

Gibt Changesets für eine bestimmte Liste von Changeset-IDs zurück.

function getBatchedChangesets(changesetsRequestData: TfvcChangesetsRequestData): Promise<TfvcChangesetRef[]>

Parameter

changesetsRequestData
TfvcChangesetsRequestData

Liste der Changeset-IDs.

Gibt zurück

Promise<TfvcChangesetRef[]>

getBranch(string, string, boolean, boolean)

Rufen Sie eine einzelne Verzweigungshierarchie am angegebenen Pfad mit den angegebenen übergeordneten oder untergeordneten Elementen ab.

function getBranch(path: string, project?: string, includeParent?: boolean, includeChildren?: boolean): Promise<TfvcBranch>

Parameter

path

string

Vollständiger Pfad zum Branch. Standardwert: $/ Beispiele: $/, $/MyProject, $/MyProject/SomeFolder.

project

string

Projekt-ID oder Projektname

includeParent

boolean

Gibt den übergeordneten Branch zurück, falls vorhanden. Standardwert: False

includeChildren

boolean

Gibt untergeordnete Verzweigungen zurück, falls vorhanden. Standardwert: False

Gibt zurück

Promise<TfvcBranch>

getBranches(string, boolean, boolean, boolean, boolean)

Rufen Sie eine Auflistung von Verzweigungsstammen ab– untergeordnete Elemente der ersten Ebene, Verzweigungen ohne Eltern.

function getBranches(project?: string, includeParent?: boolean, includeChildren?: boolean, includeDeleted?: boolean, includeLinks?: boolean): Promise<TfvcBranch[]>

Parameter

project

string

Projekt-ID oder Projektname

includeParent

boolean

Gibt den übergeordneten Branch zurück, falls vorhanden. Standardwert: False

includeChildren

boolean

Gibt die untergeordneten Branches für jeden Stammbranch zurück. Standardwert: False

includeDeleted

boolean

Gibt gelöschte Branches zurück. Standardwert: False

includeLinks

boolean

Gibt Links zurück. Standardwert: False

Gibt zurück

Promise<TfvcBranch[]>

getBranchRefs(string, string, boolean, boolean)

Abrufen von Branchhierarchien unterhalb des angegebenen scopePath

function getBranchRefs(scopePath: string, project?: string, includeDeleted?: boolean, includeLinks?: boolean): Promise<TfvcBranchRef[]>

Parameter

scopePath

string

Vollständiger Pfad zum Branch. Standardwert: $/ Beispiele: $/, $/MyProject, $/MyProject/SomeFolder.

project

string

Projekt-ID oder Projektname

includeDeleted

boolean

Gibt gelöschte Branches zurück. Standardwert: False

includeLinks

boolean

Gibt Links zurück. Standardwert: False

Gibt zurück

Promise<TfvcBranchRef[]>

getChangeset(number, string, number, boolean, boolean, number, boolean, number, number, string, TfvcChangesetSearchCriteria)

Abrufen eines Tfvc-Changesets

function getChangeset(id: number, project?: string, maxChangeCount?: number, includeDetails?: boolean, includeWorkItems?: boolean, maxCommentLength?: number, includeSourceRename?: boolean, skip?: number, top?: number, orderby?: string, searchCriteria?: TfvcChangesetSearchCriteria): Promise<TfvcChangeset>

Parameter

id

number

Abzurufende Changeset-ID.

project

string

Projekt-ID oder Projektname

maxChangeCount

number

Anzahl der zurückzugebenden Änderungen (maximal 100 Änderungen) Standardwert: 0

includeDetails

boolean

Fügen Sie Richtliniendetails und Einchecknotizen in die Antwort ein. Standardwert: FALSE

includeWorkItems

boolean

Schließen Sie Arbeitselemente ein. Standardwert: FALSE

maxCommentLength

number

Fügen Sie Details zu zugeordneten Arbeitselementen in die Antwort ein. Standard: NULL

includeSourceRename

boolean

Umbenennungen einschließen. Standardwert: FALSE

skip

number

Anzahl der zu überspringenden Ergebnisse. Standard: NULL

top

number

Die maximale Anzahl der zurückzugebenden Ergebnisse. Standard: NULL

orderby

string

Die Ergebnisse werden standardmäßig in absteigender Reihenfolge nach ID sortiert. Verwenden Sie id asc, um nach ID in aufsteigender Reihenfolge zu sortieren.

searchCriteria
TfvcChangesetSearchCriteria

Die folgenden verfügbaren Kriterien (.itemPath, .version, .versionType, .versionOption, .author, .fromId, .toId, .fromDate, .toDate) Standardwert: null

Gibt zurück

Promise<TfvcChangeset>

getChangesetChanges(number, number, number)

Rufen Sie Tfvc-Änderungen für ein bestimmtes Changeset ab.

function getChangesetChanges(id?: number, skip?: number, top?: number): Promise<PagedList<TfvcChange>>

Parameter

id

number

ID des Changesets. Standard: NULL

skip

number

Anzahl der zu überspringenden Ergebnisse. Standard: NULL

top

number

Die maximale Anzahl der zurückzugebenden Ergebnisse. Standard: NULL

Gibt zurück

Promise<PagedList<TfvcChange>>

getChangesets(string, number, number, number, string, TfvcChangesetSearchCriteria)

Abrufen von Tfvc Changesets

function getChangesets(project?: string, maxCommentLength?: number, skip?: number, top?: number, orderby?: string, searchCriteria?: TfvcChangesetSearchCriteria): Promise<TfvcChangesetRef[]>

Parameter

project

string

Projekt-ID oder Projektname

maxCommentLength

number

Fügen Sie Details zu zugeordneten Arbeitselementen in die Antwort ein. Standard: NULL

skip

number

Anzahl der zu überspringenden Ergebnisse. Standard: NULL

top

number

Die maximale Anzahl der zurückzugebenden Ergebnisse. Standard: NULL

orderby

string

Die Ergebnisse werden standardmäßig in absteigender Reihenfolge nach ID sortiert. Verwenden Sie id asc, um nach ID in aufsteigender Reihenfolge zu sortieren.

searchCriteria
TfvcChangesetSearchCriteria

Die folgenden verfügbaren Kriterien (.itemPath, .version, .versionType, .versionOption, .author, .fromId, .toId, .fromDate, .toDate) Standardwert: null

Gibt zurück

Promise<TfvcChangesetRef[]>

getChangesetWorkItems(number)

Ruft die Arbeitselemente ab, die einem bestimmten Changeset zugeordnet sind.

function getChangesetWorkItems(id?: number): Promise<AssociatedWorkItem[]>

Parameter

id

number

ID des Changesets.

Gibt zurück

Promise<AssociatedWorkItem[]>

getItem(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

function getItem(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<TfvcItem>

Parameter

path

string

Versionskontrollpfad eines einzelnen elements, das zurückgegeben werden soll.

project

string

Projekt-ID oder Projektname

fileName

string

Dateiname des zurückgegebenen Elements.

download

boolean

Wenn true, erstellen Sie eine herunterladbare Anlage.

scopePath

string

Versionskontrollpfad eines Ordners, um mehrere Elemente zurückzugeben.

recursionLevel
VersionControlRecursionType

Keine (nur das Element) oder OneLevel (Inhalt eines Ordners).

versionDescriptor
TfvcVersionDescriptor

Versionsdeskriptor. Der Standardwert lautet null.

includeContent

boolean

Legen Sie diesen Wert auf true fest, um Elementinhalte beim Anfordern von JSON einzuschließen. Der Standardwert ist "false".

Gibt zurück

Promise<TfvcItem>

getItemContent(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

function getItemContent(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>

Parameter

path

string

Versionskontrollpfad eines einzelnen elements, das zurückgegeben werden soll.

project

string

Projekt-ID oder Projektname

fileName

string

Dateiname des zurückgegebenen Elements.

download

boolean

Wenn true, erstellen Sie eine herunterladbare Anlage.

scopePath

string

Versionskontrollpfad eines Ordners, um mehrere Elemente zurückzugeben.

recursionLevel
VersionControlRecursionType

Keine (nur das Element) oder OneLevel (Inhalt eines Ordners).

versionDescriptor
TfvcVersionDescriptor

Versionsdeskriptor. Der Standardwert lautet null.

includeContent

boolean

Legen Sie diesen Wert auf true fest, um Elementinhalte beim Anfordern von JSON einzuschließen. Der Standardwert ist "false".

Gibt zurück

Promise<ArrayBuffer>

getItems(string, string, VersionControlRecursionType, boolean, TfvcVersionDescriptor)

Abrufen einer Liste von Tfvc-Elementen

function getItems(project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeLinks?: boolean, versionDescriptor?: TfvcVersionDescriptor): Promise<TfvcItem[]>

Parameter

project

string

Projekt-ID oder Projektname

scopePath

string

Versionskontrollpfad eines Ordners, um mehrere Elemente zurückzugeben.

recursionLevel
VersionControlRecursionType

Keine (nur das Element) oder OneLevel (Inhalt eines Ordners).

includeLinks

boolean

True, um Links einzuschließen.

versionDescriptor
TfvcVersionDescriptor

Gibt zurück

Promise<TfvcItem[]>

getItemsBatch(TfvcItemRequestData, string)

Posten sie zum Abrufen einer Gruppe von Elementen, die eine Liste von Pfaden oder einen langen Pfad angegeben haben. Ermöglicht das Angeben der rekursionLevel- und Versionsdeskriptoren für jeden Pfad.

function getItemsBatch(itemRequestData: TfvcItemRequestData, project?: string): Promise<TfvcItem[][]>

Parameter

itemRequestData
TfvcItemRequestData
project

string

Projekt-ID oder Projektname

Gibt zurück

Promise<TfvcItem[][]>

getItemsBatchZip(TfvcItemRequestData, string)

Posten sie zum Abrufen einer Gruppe von Elementen, die eine Liste von Pfaden oder einen langen Pfad angegeben haben. Ermöglicht das Angeben der rekursionLevel- und Versionsdeskriptoren für jeden Pfad.

function getItemsBatchZip(itemRequestData: TfvcItemRequestData, project?: string): Promise<ArrayBuffer>

Parameter

itemRequestData
TfvcItemRequestData
project

string

Projekt-ID oder Projektname

Gibt zurück

Promise<ArrayBuffer>

getItemText(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

function getItemText(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<string>

Parameter

path

string

Versionskontrollpfad eines einzelnen elements, das zurückgegeben werden soll.

project

string

Projekt-ID oder Projektname

fileName

string

Dateiname des zurückgegebenen Elements.

download

boolean

Wenn true, erstellen Sie eine herunterladbare Anlage.

scopePath

string

Versionskontrollpfad eines Ordners, um mehrere Elemente zurückzugeben.

recursionLevel
VersionControlRecursionType

Keine (nur das Element) oder OneLevel (Inhalt eines Ordners).

versionDescriptor
TfvcVersionDescriptor

Versionsdeskriptor. Der Standardwert lautet null.

includeContent

boolean

Legen Sie diesen Wert auf true fest, um Elementinhalte beim Anfordern von JSON einzuschließen. Der Standardwert ist "false".

Gibt zurück

Promise<string>

getItemZip(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)

Abrufen von Elementmetadaten und/oder Inhalten für ein einzelnes Element. Der download-Parameter gibt an, ob der Inhalt als Download verfügbar oder einfach als Stream in der Antwort gesendet werden soll. Gilt nicht für gezippten Inhalt, der immer als Download zurückgegeben wird.

function getItemZip(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>

Parameter

path

string

Versionskontrollpfad eines einzelnen elements, das zurückgegeben werden soll.

project

string

Projekt-ID oder Projektname

fileName

string

Dateiname des zurückgegebenen Elements.

download

boolean

Wenn true, erstellen Sie eine herunterladbare Anlage.

scopePath

string

Versionskontrollpfad eines Ordners, um mehrere Elemente zurückzugeben.

recursionLevel
VersionControlRecursionType

Keine (nur das Element) oder OneLevel (Inhalt eines Ordners).

versionDescriptor
TfvcVersionDescriptor

Versionsdeskriptor. Der Standardwert lautet null.

includeContent

boolean

Legen Sie diesen Wert auf true fest, um Elementinhalte beim Anfordern von JSON einzuschließen. Der Standardwert ist "false".

Gibt zurück

Promise<ArrayBuffer>

getLabel(string, TfvcLabelRequestData, string)

Rufen Sie eine einzelne deep-Bezeichnung ab.

function getLabel(labelId: string, requestData: TfvcLabelRequestData, project?: string): Promise<TfvcLabel>

Parameter

labelId

string

Eindeutiger Bezeichner der Bezeichnung

requestData
TfvcLabelRequestData

maxItemCount

project

string

Projekt-ID oder Projektname

Gibt zurück

Promise<TfvcLabel>

getLabelItems(string, number, number)

Ruft Elemente unter einer Bezeichnung ab.

function getLabelItems(labelId: string, top?: number, skip?: number): Promise<TfvcItem[]>

Parameter

labelId

string

Eindeutiger Bezeichner der Bezeichnung

top

number

Maximale Anzahl der zurückzugebenden Elemente

skip

number

Anzahl der zu überspringenden Elemente

Gibt zurück

Promise<TfvcItem[]>

getLabels(TfvcLabelRequestData, string, number, number)

Rufen Sie eine Auflistung flacher Bezeichnungsverweise ab.

function getLabels(requestData: TfvcLabelRequestData, project?: string, top?: number, skip?: number): Promise<TfvcLabelRef[]>

Parameter

requestData
TfvcLabelRequestData

labelScope, Name, Besitzer und itemLabelFilter

project

string

Projekt-ID oder Projektname

top

number

Maximale Anzahl der zurückzugebenden Bezeichnungen, Standardwert 100, wenn nicht definiert

skip

number

Anzahl der zu überspringenden Bezeichnungen

Gibt zurück

Promise<TfvcLabelRef[]>

getShelveset(string, TfvcShelvesetRequestData)

Rufen Sie ein einzelnes deep shelveset ab.

function getShelveset(shelvesetId: string, requestData?: TfvcShelvesetRequestData): Promise<TfvcShelveset>

Parameter

shelvesetId

string

Die eindeutige ID des Shelvesets

requestData
TfvcShelvesetRequestData

includeDetails, includeWorkItems, maxChangeCount und maxCommentLength

Gibt zurück

Promise<TfvcShelveset>

getShelvesetChanges(string, number, number)

Abrufen von Änderungen, die in einem Shelveset enthalten sind.

function getShelvesetChanges(shelvesetId: string, top?: number, skip?: number): Promise<TfvcChange[]>

Parameter

shelvesetId

string

Die eindeutige ID des Shelvesets

top

number

Maximale Anzahl der zurückzugebenden Änderungen

skip

number

Anzahl der zu überspringenden Änderungen

Gibt zurück

Promise<TfvcChange[]>

getShelvesets(TfvcShelvesetRequestData, number, number)

Gibt eine Auflistung flacher Shelveset-Verweise zurück.

function getShelvesets(requestData?: TfvcShelvesetRequestData, top?: number, skip?: number): Promise<TfvcShelvesetRef[]>

Parameter

requestData
TfvcShelvesetRequestData

name, besitzer und maxCommentLength

top

number

Maximale Anzahl der zurückzugebenden Shelvesets

skip

number

Anzahl der zu überspringenden Shelvesets

Gibt zurück

Promise<TfvcShelvesetRef[]>

getShelvesetWorkItems(string)

Ruft Arbeitselemente ab, die einem Shelveset zugeordnet sind.

function getShelvesetWorkItems(shelvesetId: string): Promise<AssociatedWorkItem[]>

Parameter

shelvesetId

string

Die eindeutige ID des Shelvesets

Gibt zurück

Promise<AssociatedWorkItem[]>

getTfvcStatistics(string, string)

Stellt die Dateianzahl und unkomprimierte Bytes für eine Sammlung/ein Projekt in einem bestimmten Bereich für TFVC bereit.

function getTfvcStatistics(project?: string, scopePath?: string): Promise<TfvcStatistics>

Parameter

project

string

Projekt-ID oder Projektname

scopePath

string

"$/" für sammlung, "$/project" für ein bestimmtes Projekt

Gibt zurück

Promise<TfvcStatistics>