TfvcRestClient class
Classe base que deve ser usada (derivada de) para fazer solicitações para APIs REST do VSS
- Extends
Construtores
| Tfvc |
Propriedades
| RESOURCE_AREA_ID |
Métodos
| create |
Crie um novo conjunto de alterações. |
| get |
Retorna conjuntos de alterações para uma determinada lista de IDs de conjunto de alterações. |
| get |
Obtenha uma hierarquia de ramificação única no caminho determinado com pais ou filhos, conforme especificado. |
| get |
Obtenha uma coleção de raízes de ramos -- filhos de primeiro nível, ramos sem pais. |
| get |
Obter hierarquias de ramificação abaixo do scopePath especificado |
| get |
Recuperar um conjunto de alterações Tfvc |
| get |
Recupere alterações de Tfvc para um determinado conjunto de alterações. |
| get |
Recuperar conjuntos de alterações Tfvc |
| get |
Recupera os itens de trabalho associados a um conjunto de alterações específico. |
| get |
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download. |
| get |
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download. |
| get |
Obter uma lista de itens Tfvc |
| get |
Post para recuperar um conjunto de itens dada uma lista de caminhos ou um caminho longo. Permite especificar os descritores recursionLevel e version para cada caminho. |
| get |
Post para recuperar um conjunto de itens dada uma lista de caminhos ou um caminho longo. Permite especificar os descritores recursionLevel e version para cada caminho. |
| get |
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download. |
| get |
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download. |
| get |
Obtenha um único rótulo profundo. |
| get |
Obter itens sob uma etiqueta. |
| get |
Obtenha uma coleção de referências de rótulos superficiais. |
| get |
Obtenha um único conjunto de prateleiras profundas. |
| get |
Obtenha alterações incluídas em um conjunto de prateleiras. |
| get |
Retornar uma coleção de referências de conjunto de prateleiras rasas. |
| get |
Obtenha itens de trabalho associados a um conjunto de prateleiras. |
| get |
Fornece contagem de arquivos e bytes não compactados para uma coleção/projeto em um escopo específico para TFVC. |
Detalhes do Construtor
TfvcRestClient(IVssRestClientOptions)
Detalhes de Propriedade
RESOURCE_AREA_ID
static RESOURCE_AREA_ID: stringValor de Propriedade
string
Detalhes de Método
createChangeset(TfvcChangeset, string)
Crie um novo conjunto de alterações.
function createChangeset(changeset: TfvcChangeset, project?: string): Promise<TfvcChangesetRef>Parâmetros
- changeset
- TfvcChangeset
- project
-
string
ID do projeto ou nome do projeto
Devoluções
Promise<TfvcChangesetRef>
getBatchedChangesets(TfvcChangesetsRequestData)
Retorna conjuntos de alterações para uma determinada lista de IDs de conjunto de alterações.
function getBatchedChangesets(changesetsRequestData: TfvcChangesetsRequestData): Promise<TfvcChangesetRef[]>Parâmetros
- changesetsRequestData
- TfvcChangesetsRequestData
Lista de IDs do conjunto de alterações.
Devoluções
Promise<TfvcChangesetRef[]>
getBranch(string, string, boolean, boolean)
Obtenha uma hierarquia de ramificação única no caminho determinado com pais ou filhos, conforme especificado.
function getBranch(path: string, project?: string, includeParent?: boolean, includeChildren?: boolean): Promise<TfvcBranch>Parâmetros
- path
-
string
Caminho completo para o ramo. Padrão: $/ Exemplos: $/, $/MyProject, $/MyProject/SomeFolder.
- project
-
string
ID do projeto ou nome do projeto
- includeParent
-
boolean
Devolva a ramificação principal, se houver. Padrão: Falso
- includeChildren
-
boolean
Retorne ramificações filhas, se houver. Padrão: Falso
Devoluções
Promise<TfvcBranch>
getBranches(string, boolean, boolean, boolean, boolean)
Obtenha uma coleção de raízes de ramos -- filhos de primeiro nível, ramos sem pais.
function getBranches(project?: string, includeParent?: boolean, includeChildren?: boolean, includeDeleted?: boolean, includeLinks?: boolean): Promise<TfvcBranch[]>Parâmetros
- project
-
string
ID do projeto ou nome do projeto
- includeParent
-
boolean
Devolva a ramificação principal, se houver. Padrão: Falso
- includeChildren
-
boolean
Retorne as ramificações filho para cada ramificação raiz. Padrão: Falso
- includeDeleted
-
boolean
Retornar ramificações excluídas. Padrão: Falso
- includeLinks
-
boolean
Links de retorno. Padrão: Falso
Devoluções
Promise<TfvcBranch[]>
getBranchRefs(string, string, boolean, boolean)
Obter hierarquias de ramificação abaixo do scopePath especificado
function getBranchRefs(scopePath: string, project?: string, includeDeleted?: boolean, includeLinks?: boolean): Promise<TfvcBranchRef[]>Parâmetros
- scopePath
-
string
Caminho completo para o ramo. Padrão: $/ Exemplos: $/, $/MyProject, $/MyProject/SomeFolder.
- project
-
string
ID do projeto ou nome do projeto
- includeDeleted
-
boolean
Retornar ramificações excluídas. Padrão: Falso
- includeLinks
-
boolean
Links de retorno. Padrão: Falso
Devoluções
Promise<TfvcBranchRef[]>
getChangeset(number, string, number, boolean, boolean, number, boolean, number, number, string, TfvcChangesetSearchCriteria)
Recuperar um conjunto de alterações 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>Parâmetros
- id
-
number
ID do conjunto de alterações a recuperar.
- project
-
string
ID do projeto ou nome do projeto
- maxChangeCount
-
number
Número de alterações a devolver (máximo de 100 alterações) Padrão: 0
- includeDetails
-
boolean
Inclua detalhes da política e notas de check-in na resposta. Padrão: false
- includeWorkItems
-
boolean
Inclua itens de trabalho. Padrão: false
- maxCommentLength
-
number
Inclua detalhes sobre itens de trabalho associados na resposta. Padrão: null
- includeSourceRename
-
boolean
Inclua renomes. Padrão: false
- skip
-
number
Número de resultados a ignorar. Padrão: null
- top
-
number
O número máximo de resultados a serem retornados. Padrão: null
- orderby
-
string
Os resultados são classificados por ID em ordem decrescente por padrão. Use id asc para classificar por ID em ordem crescente.
- searchCriteria
- TfvcChangesetSearchCriteria
Critérios disponíveis (.itemPath, .version, .versionType, .versionOption, .author, .fromId, .toId, .fromDate, .toDate) Padrão: null
Devoluções
Promise<TfvcChangeset>
getChangesetChanges(number, number, number)
Recupere alterações de Tfvc para um determinado conjunto de alterações.
function getChangesetChanges(id?: number, skip?: number, top?: number): Promise<PagedList<TfvcChange>>Parâmetros
- id
-
number
ID do conjunto de alterações. Padrão: null
- skip
-
number
Número de resultados a ignorar. Padrão: null
- top
-
number
O número máximo de resultados a serem retornados. Padrão: null
Devoluções
Promise<PagedList<TfvcChange>>
getChangesets(string, number, number, number, string, TfvcChangesetSearchCriteria)
Recuperar conjuntos de alterações Tfvc
function getChangesets(project?: string, maxCommentLength?: number, skip?: number, top?: number, orderby?: string, searchCriteria?: TfvcChangesetSearchCriteria): Promise<TfvcChangesetRef[]>Parâmetros
- project
-
string
ID do projeto ou nome do projeto
- maxCommentLength
-
number
Inclua detalhes sobre itens de trabalho associados na resposta. Padrão: null
- skip
-
number
Número de resultados a ignorar. Padrão: null
- top
-
number
O número máximo de resultados a serem retornados. Padrão: null
- orderby
-
string
Os resultados são classificados por ID em ordem decrescente por padrão. Use id asc para classificar por ID em ordem crescente.
- searchCriteria
- TfvcChangesetSearchCriteria
Critérios disponíveis (.itemPath, .version, .versionType, .versionOption, .author, .fromId, .toId, .fromDate, .toDate) Padrão: null
Devoluções
Promise<TfvcChangesetRef[]>
getChangesetWorkItems(number)
Recupera os itens de trabalho associados a um conjunto de alterações específico.
function getChangesetWorkItems(id?: number): Promise<AssociatedWorkItem[]>Parâmetros
- id
-
number
ID do conjunto de alterações.
Devoluções
Promise<AssociatedWorkItem[]>
getItem(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download.
function getItem(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<TfvcItem>Parâmetros
- path
-
string
Caminho de controle de versão de um item individual a ser retornado.
- project
-
string
ID do projeto ou nome do projeto
- fileName
-
string
Nome do arquivo do item retornado.
- download
-
boolean
Se verdadeiro, crie um anexo para download.
- scopePath
-
string
Caminho de controle de versão de uma pasta para retornar vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versão. O padrão é null.
- includeContent
-
boolean
Defina como true para incluir o conteúdo do item ao solicitar json. O padrão é false.
Devoluções
Promise<TfvcItem>
getItemContent(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download.
function getItemContent(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>Parâmetros
- path
-
string
Caminho de controle de versão de um item individual a ser retornado.
- project
-
string
ID do projeto ou nome do projeto
- fileName
-
string
Nome do arquivo do item retornado.
- download
-
boolean
Se verdadeiro, crie um anexo para download.
- scopePath
-
string
Caminho de controle de versão de uma pasta para retornar vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versão. O padrão é null.
- includeContent
-
boolean
Defina como true para incluir o conteúdo do item ao solicitar json. O padrão é false.
Devoluções
Promise<ArrayBuffer>
getItems(string, string, VersionControlRecursionType, boolean, TfvcVersionDescriptor)
Obter uma lista de itens Tfvc
function getItems(project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeLinks?: boolean, versionDescriptor?: TfvcVersionDescriptor): Promise<TfvcItem[]>Parâmetros
- project
-
string
ID do projeto ou nome do projeto
- scopePath
-
string
Caminho de controle de versão de uma pasta para retornar vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- includeLinks
-
boolean
True para incluir links.
- versionDescriptor
- TfvcVersionDescriptor
Devoluções
Promise<TfvcItem[]>
getItemsBatch(TfvcItemRequestData, string)
Post para recuperar um conjunto de itens dada uma lista de caminhos ou um caminho longo. Permite especificar os descritores recursionLevel e version para cada caminho.
function getItemsBatch(itemRequestData: TfvcItemRequestData, project?: string): Promise<TfvcItem[][]>Parâmetros
- itemRequestData
- TfvcItemRequestData
- project
-
string
ID do projeto ou nome do projeto
Devoluções
Promise<TfvcItem[][]>
getItemsBatchZip(TfvcItemRequestData, string)
Post para recuperar um conjunto de itens dada uma lista de caminhos ou um caminho longo. Permite especificar os descritores recursionLevel e version para cada caminho.
function getItemsBatchZip(itemRequestData: TfvcItemRequestData, project?: string): Promise<ArrayBuffer>Parâmetros
- itemRequestData
- TfvcItemRequestData
- project
-
string
ID do projeto ou nome do projeto
Devoluções
Promise<ArrayBuffer>
getItemText(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download.
function getItemText(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<string>Parâmetros
- path
-
string
Caminho de controle de versão de um item individual a ser retornado.
- project
-
string
ID do projeto ou nome do projeto
- fileName
-
string
Nome do arquivo do item retornado.
- download
-
boolean
Se verdadeiro, crie um anexo para download.
- scopePath
-
string
Caminho de controle de versão de uma pasta para retornar vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versão. O padrão é null.
- includeContent
-
boolean
Defina como true para incluir o conteúdo do item ao solicitar json. O padrão é false.
Devoluções
Promise<string>
getItemZip(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
Obter Metadados e/ou Conteúdo do Item para um único item. O parâmetro de download é para indicar se o conteúdo deve estar disponível como um download ou apenas enviado como um fluxo na resposta. Não se aplica a conteúdo compactado que é sempre retornado como um download.
function getItemZip(path: string, project?: string, fileName?: string, download?: boolean, scopePath?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: TfvcVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>Parâmetros
- path
-
string
Caminho de controle de versão de um item individual a ser retornado.
- project
-
string
ID do projeto ou nome do projeto
- fileName
-
string
Nome do arquivo do item retornado.
- download
-
boolean
Se verdadeiro, crie um anexo para download.
- scopePath
-
string
Caminho de controle de versão de uma pasta para retornar vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versão. O padrão é null.
- includeContent
-
boolean
Defina como true para incluir o conteúdo do item ao solicitar json. O padrão é false.
Devoluções
Promise<ArrayBuffer>
getLabel(string, TfvcLabelRequestData, string)
Obtenha um único rótulo profundo.
function getLabel(labelId: string, requestData: TfvcLabelRequestData, project?: string): Promise<TfvcLabel>Parâmetros
- labelId
-
string
Identificador único do rótulo
- requestData
- TfvcLabelRequestData
maxItemCount
- project
-
string
ID do projeto ou nome do projeto
Devoluções
Promise<TfvcLabel>
getLabelItems(string, number, number)
Obter itens sob uma etiqueta.
function getLabelItems(labelId: string, top?: number, skip?: number): Promise<TfvcItem[]>Parâmetros
- labelId
-
string
Identificador único do rótulo
- top
-
number
Número máximo de itens a devolver
- skip
-
number
Número de itens a serem ignorados
Devoluções
Promise<TfvcItem[]>
getLabels(TfvcLabelRequestData, string, number, number)
Obtenha uma coleção de referências de rótulos superficiais.
function getLabels(requestData: TfvcLabelRequestData, project?: string, top?: number, skip?: number): Promise<TfvcLabelRef[]>Parâmetros
- requestData
- TfvcLabelRequestData
labelScope, nome, proprietário e itemLabelFilter
- project
-
string
ID do projeto ou nome do projeto
- top
-
number
Número máximo de etiquetas a serem retornadas, o padrão é 100 quando indefinido
- skip
-
number
Número de etiquetas a ignorar
Devoluções
Promise<TfvcLabelRef[]>
getShelveset(string, TfvcShelvesetRequestData)
Obtenha um único conjunto de prateleiras profundas.
function getShelveset(shelvesetId: string, requestData?: TfvcShelvesetRequestData): Promise<TfvcShelveset>Parâmetros
- shelvesetId
-
string
ID exclusivo da Shelveset
- requestData
- TfvcShelvesetRequestData
includeDetails, includeWorkItems, maxChangeCount e maxCommentLength
Devoluções
Promise<TfvcShelveset>
getShelvesetChanges(string, number, number)
Obtenha alterações incluídas em um conjunto de prateleiras.
function getShelvesetChanges(shelvesetId: string, top?: number, skip?: number): Promise<TfvcChange[]>Parâmetros
- shelvesetId
-
string
ID exclusivo da Shelveset
- top
-
number
Número máximo de alterações a devolver
- skip
-
number
Número de alterações a ignorar
Devoluções
Promise<TfvcChange[]>
getShelvesets(TfvcShelvesetRequestData, number, number)
Retornar uma coleção de referências de conjunto de prateleiras rasas.
function getShelvesets(requestData?: TfvcShelvesetRequestData, top?: number, skip?: number): Promise<TfvcShelvesetRef[]>Parâmetros
- requestData
- TfvcShelvesetRequestData
nome, proprietário e maxCommentLength
- top
-
number
Número máximo de prateleiras a devolver
- skip
-
number
Número de prateleiras a saltar
Devoluções
Promise<TfvcShelvesetRef[]>
getShelvesetWorkItems(string)
Obtenha itens de trabalho associados a um conjunto de prateleiras.
function getShelvesetWorkItems(shelvesetId: string): Promise<AssociatedWorkItem[]>Parâmetros
- shelvesetId
-
string
ID exclusivo da Shelveset
Devoluções
Promise<AssociatedWorkItem[]>
getTfvcStatistics(string, string)
Fornece contagem de arquivos e bytes não compactados para uma coleção/projeto em um escopo específico para TFVC.
function getTfvcStatistics(project?: string, scopePath?: string): Promise<TfvcStatistics>Parâmetros
- project
-
string
ID do projeto ou nome do projeto
- scopePath
-
string
'$/' para coleção, '$/projeto' para projeto específico
Devoluções
Promise<TfvcStatistics>