TfvcRestClient class
應該使用 (衍生自) 的基類，向 VSS REST API 提出要求
- Extends
建構函式
| Tfvc |
屬性
| RESOURCE_AREA_ID |
方法
建構函式詳細資料
TfvcRestClient(IVssRestClientOptions)
屬性詳細資料
RESOURCE_AREA_ID
static RESOURCE_AREA_ID: string屬性值
string
方法詳細資料
createChangeset(TfvcChangeset, string)
建立新的變更集。
function createChangeset(changeset: TfvcChangeset, project?: string): Promise<TfvcChangesetRef>參數
- changeset
- TfvcChangeset
- project
-
string
專案識別碼或專案名稱
傳回
Promise<TfvcChangesetRef>
getBatchedChangesets(TfvcChangesetsRequestData)
傳回指定變更集識別碼清單的變更集。
function getBatchedChangesets(changesetsRequestData: TfvcChangesetsRequestData): Promise<TfvcChangesetRef[]>參數
- changesetsRequestData
- TfvcChangesetsRequestData
變更集識別碼的清單。
傳回
Promise<TfvcChangesetRef[]>
getBranch(string, string, boolean, boolean)
取得指定路徑上具有父系或子系的單一分支階層，如指定。
function getBranch(path: string, project?: string, includeParent?: boolean, includeChildren?: boolean): Promise<TfvcBranch>參數
- path
-
string
分支的完整路徑。 預設值：$/ 範例：$/、$/MyProject、$/MyProject/SomeFolder。
- project
-
string
專案識別碼或專案名稱
- includeParent
-
boolean
如果有，則傳回父分支。 預設值：False
- includeChildren
-
boolean
如果有的話，則傳回子分支。 預設值：False
傳回
Promise<TfvcBranch>
getBranches(string, boolean, boolean, boolean, boolean)
取得分支根的集合 -- 第一層子系，沒有父系的分支。
function getBranches(project?: string, includeParent?: boolean, includeChildren?: boolean, includeDeleted?: boolean, includeLinks?: boolean): Promise<TfvcBranch[]>參數
- project
-
string
專案識別碼或專案名稱
- includeParent
-
boolean
如果有，則傳回父分支。 預設值：False
- includeChildren
-
boolean
傳回每個根分支的子分支。 預設值：False
- includeDeleted
-
boolean
傳回已刪除的分支。 預設值：False
- includeLinks
-
boolean
傳回連結。 預設值：False
傳回
Promise<TfvcBranch[]>
getBranchRefs(string, string, boolean, boolean)
取得指定 scopePath 下方的分支階層
function getBranchRefs(scopePath: string, project?: string, includeDeleted?: boolean, includeLinks?: boolean): Promise<TfvcBranchRef[]>參數
- scopePath
-
string
分支的完整路徑。 預設值：$/ 範例：$/、$/MyProject、$/MyProject/SomeFolder。
- project
-
string
專案識別碼或專案名稱
- includeDeleted
-
boolean
傳回已刪除的分支。 預設值：False
- includeLinks
-
boolean
傳回連結。 預設值：False
傳回
Promise<TfvcBranchRef[]>
getChangeset(number, string, number, boolean, boolean, number, boolean, number, number, string, TfvcChangesetSearchCriteria)
擷取 Tfvc 變更集
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>參數
- id
-
number
要擷取的變更集識別碼。
- project
-
string
專案識別碼或專案名稱
- maxChangeCount
-
number
) 預設值 (傳回最多 100 個變更的變更數目：0
- includeDetails
-
boolean
在回應中包含原則詳細資料和簽入附注。 預設值：false
- includeWorkItems
-
boolean
包含 workitems。 預設值：false
- maxCommentLength
-
number
在回應中包含相關聯工作專案的詳細資料。 預設值：null
- includeSourceRename
-
boolean
包含重新命名。 預設值：false
- skip
-
number
要略過的結果數目。 預設值：null
- top
-
number
要傳回的結果數目上限。 預設值：null
- orderby
-
string
根據預設，結果會依識別碼遞減順序排序。 使用 id asc 以遞增順序依識別碼排序。
- searchCriteria
- TfvcChangesetSearchCriteria
下列準則 (.itemPath、.version、.versionType、.versionOption、.author、.fromId、.toId、.fromDate、.toDate) Default： null
傳回
Promise<TfvcChangeset>
getChangesetChanges(number, number, number)
擷取指定變更集的 Tfvc 變更。
function getChangesetChanges(id?: number, skip?: number, top?: number): Promise<PagedList<TfvcChange>>參數
- id
-
number
變更集的識別碼。 預設值：null
- skip
-
number
要略過的結果數目。 預設值：null
- top
-
number
要傳回的結果數目上限。 預設值：null
傳回
Promise<PagedList<TfvcChange>>
getChangesets(string, number, number, number, string, TfvcChangesetSearchCriteria)
擷取 Tfvc 變更集
function getChangesets(project?: string, maxCommentLength?: number, skip?: number, top?: number, orderby?: string, searchCriteria?: TfvcChangesetSearchCriteria): Promise<TfvcChangesetRef[]>參數
- project
-
string
專案識別碼或專案名稱
- maxCommentLength
-
number
在回應中包含相關聯工作專案的詳細資料。 預設值：null
- skip
-
number
要略過的結果數目。 預設值：null
- top
-
number
要傳回的結果數目上限。 預設值：null
- orderby
-
string
根據預設，結果會依識別碼遞減順序排序。 使用 id asc 以遞增順序依識別碼排序。
- searchCriteria
- TfvcChangesetSearchCriteria
下列準則 (.itemPath、.version、.versionType、.versionOption、.author、.fromId、.toId、.fromDate、.toDate) Default： null
傳回
Promise<TfvcChangesetRef[]>
getChangesetWorkItems(number)
擷取與特定變更集相關聯的工作專案。
function getChangesetWorkItems(id?: number): Promise<AssociatedWorkItem[]>參數
- id
-
number
變更集的識別碼。
傳回
Promise<AssociatedWorkItem[]>
getItem(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
取得單一專案的專案中繼資料和/或內容。 下載參數是指出內容是否應該以下載的形式提供，或只是以回應中的資料流程的形式傳送。 不適用於一律以下載方式傳回的壓縮內容。
function getItem(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<TfvcItem>參數
- path
-
string
要傳回之個別專案的版本控制路徑。
- project
-
string
專案識別碼或專案名稱
- fileName
-
string
傳回專案的檔案名。
- download
-
boolean
如果為 true，請建立可下載的附件。
- scopePath
-
string
要傳回多個專案的資料夾版本控制路徑。
- recursionLevel
- VersionControlRecursionType
無 (只) 或 OneLevel (資料夾) 的內容。
- versionDescriptor
- TfvcVersionDescriptor
版本描述元。 預設為 Null。
- includeContent
-
boolean
設定為 true，以在要求 json 時包含專案內容。 預設值為 false。
傳回
Promise<TfvcItem>
getItemContent(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
取得單一專案的專案中繼資料和/或內容。 下載參數是指出內容是否應該以下載的形式提供，或只是以回應中的資料流程的形式傳送。 不適用於一律以下載方式傳回的壓縮內容。
function getItemContent(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>參數
- path
-
string
要傳回之個別專案的版本控制路徑。
- project
-
string
專案識別碼或專案名稱
- fileName
-
string
傳回專案的檔案名。
- download
-
boolean
如果為 true，請建立可下載的附件。
- scopePath
-
string
要傳回多個專案的資料夾版本控制路徑。
- recursionLevel
- VersionControlRecursionType
無 (只) 或 OneLevel (資料夾) 的內容。
- versionDescriptor
- TfvcVersionDescriptor
版本描述元。 預設為 Null。
- includeContent
-
boolean
設定為 true，以在要求 json 時包含專案內容。 預設值為 false。
傳回
Promise<ArrayBuffer>
getItems(string, string, VersionControlRecursionType, boolean, TfvcVersionDescriptor)
取得 Tfvc 專案的清單
function getItems(project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeLinks?: boolean, versionDescriptor?: TfvcVersionDescriptor): Promise<TfvcItem[]>參數
- project
-
string
專案識別碼或專案名稱
- scopePath
-
string
要傳回多個專案的資料夾版本控制路徑。
- recursionLevel
- VersionControlRecursionType
無 (只) 或 OneLevel (資料夾) 的內容。
- includeLinks
-
boolean
True 是表示 包含連結。
- versionDescriptor
- TfvcVersionDescriptor
傳回
Promise<TfvcItem[]>
getItemsBatch(TfvcItemRequestData, string)
張貼以擷取一組指定路徑清單或長路徑的專案。 允許指定每個路徑的遞迴Level 和版本描述元。
function getItemsBatch(itemRequestData: TfvcItemRequestData, project?: string): Promise<TfvcItem[][]>參數
- itemRequestData
- TfvcItemRequestData
- project
-
string
專案識別碼或專案名稱
傳回
Promise<TfvcItem[][]>
getItemsBatchZip(TfvcItemRequestData, string)
張貼以擷取一組指定路徑清單或長路徑的專案。 允許指定每個路徑的遞迴Level 和版本描述元。
function getItemsBatchZip(itemRequestData: TfvcItemRequestData, project?: string): Promise<ArrayBuffer>參數
- itemRequestData
- TfvcItemRequestData
- project
-
string
專案識別碼或專案名稱
傳回
Promise<ArrayBuffer>
getItemText(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
取得單一專案的專案中繼資料和/或內容。 下載參數是指出內容是否應該以下載的形式提供，或只是以回應中的資料流程的形式傳送。 不適用於一律以下載方式傳回的壓縮內容。
function getItemText(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<string>參數
- path
-
string
要傳回之個別專案的版本控制路徑。
- project
-
string
專案識別碼或專案名稱
- fileName
-
string
傳回專案的檔案名。
- download
-
boolean
如果為 true，請建立可下載的附件。
- scopePath
-
string
要傳回多個專案的資料夾版本控制路徑。
- recursionLevel
- VersionControlRecursionType
無 (只) 或 OneLevel (資料夾) 的內容。
- versionDescriptor
- TfvcVersionDescriptor
版本描述元。 預設為 Null。
- includeContent
-
boolean
設定為 true，以在要求 json 時包含專案內容。 預設值為 false。
傳回
Promise<string>
getItemZip(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
取得單一專案的專案中繼資料和/或內容。 下載參數是指出內容是否應該以下載的形式提供，或只是以回應中的資料流程的形式傳送。 不適用於一律以下載方式傳回的壓縮內容。
function getItemZip(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>參數
- path
-
string
要傳回之個別專案的版本控制路徑。
- project
-
string
專案識別碼或專案名稱
- fileName
-
string
傳回專案的檔案名。
- download
-
boolean
如果為 true，請建立可下載的附件。
- scopePath
-
string
要傳回多個專案的資料夾版本控制路徑。
- recursionLevel
- VersionControlRecursionType
無 (只) 或 OneLevel (資料夾) 的內容。
- versionDescriptor
- TfvcVersionDescriptor
版本描述元。 預設為 Null。
- includeContent
-
boolean
設定為 true 以在要求 json 時包含專案內容。 預設值為 false。
傳回
Promise<ArrayBuffer>
getLabel(string, TfvcLabelRequestData, string)
取得單一深層標籤。
function getLabel(labelId: string, requestData: TfvcLabelRequestData, project?: string): Promise<TfvcLabel>參數
- labelId
-
string
標籤的唯一識別碼
- requestData
- TfvcLabelRequestData
maxItemCount
- project
-
string
專案識別碼或專案名稱
傳回
Promise<TfvcLabel>
getLabelItems(string, number, number)
取得標籤底下的專案。
function getLabelItems(labelId: string, top?: number, skip?: number): Promise<TfvcItem[]>參數
- labelId
-
string
標籤的唯一識別碼
- top
-
number
要傳回的專案數目上限
- skip
-
number
要略過的專案數
傳回
Promise<TfvcItem[]>
getLabels(TfvcLabelRequestData, string, number, number)
取得淺層標籤參考的集合。
function getLabels(requestData: TfvcLabelRequestData, project?: string, top?: number, skip?: number): Promise<TfvcLabelRef[]>參數
- requestData
- TfvcLabelRequestData
labelScope、name、owner 和 itemLabelFilter
- project
-
string
專案識別碼或專案名稱
- top
-
number
要傳回的標籤數目上限，未定義時預設為 100
- skip
-
number
要略過的標籤數目
傳回
Promise<TfvcLabelRef[]>
getShelveset(string, TfvcShelvesetRequestData)
取得單一深層擱置集。
function getShelveset(shelvesetId: string, requestData?: TfvcShelvesetRequestData): Promise<TfvcShelveset>參數
- shelvesetId
-
string
擱置集的唯一識別碼
- requestData
- TfvcShelvesetRequestData
includeDetails、includeWorkItems、maxChangeCount 和 maxCommentLength
傳回
Promise<TfvcShelveset>
getShelvesetChanges(string, number, number)
取得擱置集中包含的變更。
function getShelvesetChanges(shelvesetId: string, top?: number, skip?: number): Promise<TfvcChange[]>參數
- shelvesetId
-
string
擱置集的唯一識別碼
- top
-
number
要傳回的變更數目上限
- skip
-
number
要略過的變更數目
傳回
Promise<TfvcChange[]>
getShelvesets(TfvcShelvesetRequestData, number, number)
傳回淺層擱置集參考的集合。
function getShelvesets(requestData?: TfvcShelvesetRequestData, top?: number, skip?: number): Promise<TfvcShelvesetRef[]>參數
- requestData
- TfvcShelvesetRequestData
name、owner 和 maxCommentLength
- top
-
number
要傳回的擱置集數目上限
- skip
-
number
要略過的擱置集數目
傳回
Promise<TfvcShelvesetRef[]>
getShelvesetWorkItems(string)
取得與擱置集相關聯的工作專案。
function getShelvesetWorkItems(shelvesetId: string): Promise<AssociatedWorkItem[]>參數
- shelvesetId
-
string
擱置集的唯一識別碼
傳回
Promise<AssociatedWorkItem[]>
getTfvcStatistics(string, string)
提供 TFVC 特定範圍之集合/專案的檔案計數和未壓縮位元組。
function getTfvcStatistics(project?: string, scopePath?: string): Promise<TfvcStatistics>參數
- project
-
string
專案識別碼或專案名稱
- scopePath
-
string
集合的 '$/'，特定專案的 '$/project'
傳回
Promise<TfvcStatistics>