TfvcRestClient class
Classe base que deve ser utilizada (derivada de) para fazer pedidos às apis REST do VSS
- Extends
Construtores
| Tfvc |
Propriedades
| RESOURCE_AREA_ID |
Métodos
| create |
Crie um novo conjunto de alterações. |
| get |
Devolve conjuntos de alterações para uma determinada lista de IDs de conjuntos de alterações. |
| get |
Obtenha uma única hierarquia de ramo no caminho especificado com pais ou filhos, conforme especificado. |
| get |
Obtenha uma coleção de raízes de ramo, crianças de primeiro nível, ramos sem pais. |
| get |
Obter hierarquias de ramo abaixo do scopePath especificado |
| get |
Obter um Conjunto de Alterações Tfvc |
| get |
Obtenha as alterações de Tfvc para um determinado conjunto de alterações. |
| get |
Obter Conjuntos de Alterações do Tfvc |
| get |
Obtém os itens de trabalho associados a um conjunto de alterações específico. |
| get |
Obter Metadados de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência. |
| get |
Obter Metadados de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência. |
| get |
Obter uma lista de itens Tfvc |
| get |
Publicar para obter um conjunto de itens com uma lista de caminhos ou um caminho longo. Permite especificar os descritores de recursionLevel e versão para cada caminho. |
| get |
Publicar para obter um conjunto de itens com uma lista de caminhos ou um caminho longo. Permite especificar os descritores de recursionLevel e versão para cada caminho. |
| get |
Obter Metadados de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência. |
| get |
Obter Metadados de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência. |
| get |
Obtenha uma única etiqueta profunda. |
| get |
Obter itens numa etiqueta. |
| get |
Obtenha uma coleção de referências de etiquetas rasas. |
| get |
Obter uma única prateleira profunda. |
| get |
Obter alterações incluídas num conjunto de prateleiras. |
| get |
Devolver uma coleção de referências de conjuntos de prateleiras rasas. |
| get |
Obtenha itens de trabalho associados a um conjunto de prateleiras. |
| get |
Fornece a Contagem de Ficheiros e Bytes Não Comprimidos para uma Coleção/Projeto num âmbito 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)
Devolve conjuntos de alterações para uma determinada lista de IDs de conjuntos de alterações.
function getBatchedChangesets(changesetsRequestData: TfvcChangesetsRequestData): Promise<TfvcChangesetRef[]>Parâmetros
- changesetsRequestData
- TfvcChangesetsRequestData
Lista de IDs de conjuntos de alterações.
Devoluções
Promise<TfvcChangesetRef[]>
getBranch(string, string, boolean, boolean)
Obtenha uma única hierarquia de ramo no caminho especificado 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. Predefinição: $/ Exemplos: $/, $/MyProject, $/MyProject/SomeFolder.
- project
-
string
ID do Projeto ou nome do projeto
- includeParent
-
boolean
Devolva o ramo principal, se existir um. Predefinição: Falso
- includeChildren
-
boolean
Devolver ramos subordinados, se existirem. Predefinição: Falso
Devoluções
Promise<TfvcBranch>
getBranches(string, boolean, boolean, boolean, boolean)
Obtenha uma coleção de raízes de ramo, crianças 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 o ramo principal, se existir um. Predefinição: Falso
- includeChildren
-
boolean
Devolva os ramos subordinados para cada ramo de raiz. Predefinição: Falso
- includeDeleted
-
boolean
Devolver ramos eliminados. Predefinição: Falso
- includeLinks
-
boolean
Ligações de retorno. Predefinição: Falso
Devoluções
Promise<TfvcBranch[]>
getBranchRefs(string, string, boolean, boolean)
Obter hierarquias de ramo 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. Predefinição: $/ Exemplos: $/, $/MyProject, $/MyProject/SomeFolder.
- project
-
string
ID do Projeto ou nome do projeto
- includeDeleted
-
boolean
Devolver ramos eliminados. Predefinição: Falso
- includeLinks
-
boolean
Ligações de retorno. Predefinição: Falso
Devoluções
Promise<TfvcBranchRef[]>
getChangeset(number, string, number, boolean, boolean, number, boolean, number, number, string, TfvcChangesetSearchCriteria)
Obter 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 obter.
- project
-
string
ID do Projeto ou nome do projeto
- maxChangeCount
-
number
Número de alterações a devolver (máximo de 100 alterações) Predefinição: 0
- includeDetails
-
boolean
Inclua detalhes da política e notas de entrada na resposta. Predefinição: falso
- includeWorkItems
-
boolean
Incluir workitems. Predefinição: falso
- maxCommentLength
-
number
Inclua detalhes sobre os itens de trabalho associados na resposta. Predefinição: nulo
- includeSourceRename
-
boolean
Inclua os nomes dos nomes. Predefinição: falso
- skip
-
number
Número de resultados a ignorar. Predefinição: nulo
- top
-
number
O número máximo de resultados a devolver. Predefinição: nulo
- orderby
-
string
Os resultados são ordenados por ID por ordem descendente por predefinição. Utilize o id asc para ordenar por ID por ordem ascendente.
- searchCriteria
- TfvcChangesetSearchCriteria
Critérios seguintes disponíveis (.itemPath, .version, .versionType, .versionOption, .author, .fromId, .toId, .fromDate, .toDate) Predefinição: nulo
Devoluções
Promise<TfvcChangeset>
getChangesetChanges(number, number, number)
Obtenha as 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. Predefinição: nulo
- skip
-
number
Número de resultados a ignorar. Predefinição: nulo
- top
-
number
O número máximo de resultados a devolver. Predefinição: nulo
Devoluções
Promise<PagedList<TfvcChange>>
getChangesets(string, number, number, number, string, TfvcChangesetSearchCriteria)
Obter Conjuntos de Alterações do 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 os itens de trabalho associados na resposta. Predefinição: nulo
- skip
-
number
Número de resultados a ignorar. Predefinição: nulo
- top
-
number
O número máximo de resultados a devolver. Predefinição: nulo
- orderby
-
string
Os resultados são ordenados por ID por ordem descendente por predefinição. Utilize o id asc para ordenar por ID por ordem ascendente.
- searchCriteria
- TfvcChangesetSearchCriteria
Critérios seguintes disponíveis (.itemPath, .version, .versionType, .versionOption, .author, .fromId, .toId, .fromDate, .toDate) Predefinição: nulo
Devoluções
Promise<TfvcChangesetRef[]>
getChangesetWorkItems(number)
Obtém 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 de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência.
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 controlo de versão de um item individual a devolver.
- project
-
string
ID do Projeto ou nome do projeto
- fileName
-
string
nome de ficheiro do item devolvido.
- download
-
boolean
Se for verdadeiro, crie um anexo transferível.
- scopePath
-
string
Caminho de controlo de versão de uma pasta para devolver vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versões. A predefinição é nula.
- includeContent
-
boolean
Defina como verdadeiro para incluir conteúdo do item ao pedir json. A predefinição é falso.
Devoluções
Promise<TfvcItem>
getItemContent(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
Obter Metadados de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência.
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 controlo de versão de um item individual a devolver.
- project
-
string
ID do Projeto ou nome do projeto
- fileName
-
string
nome de ficheiro do item devolvido.
- download
-
boolean
Se for verdadeiro, crie um anexo transferível.
- scopePath
-
string
Caminho de controlo de versão de uma pasta para devolver vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versões. A predefinição é nula.
- includeContent
-
boolean
Defina como verdadeiro para incluir conteúdo do item ao pedir json. A predefinição é falso.
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 controlo de versão de uma pasta para devolver vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- includeLinks
-
boolean
Verdadeiro para incluir ligações.
- versionDescriptor
- TfvcVersionDescriptor
Devoluções
Promise<TfvcItem[]>
getItemsBatch(TfvcItemRequestData, string)
Publicar para obter um conjunto de itens com uma lista de caminhos ou um caminho longo. Permite especificar os descritores de recursionLevel e versão 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)
Publicar para obter um conjunto de itens com uma lista de caminhos ou um caminho longo. Permite especificar os descritores de recursionLevel e versão 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 de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência.
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 controlo de versão de um item individual a devolver.
- project
-
string
ID do Projeto ou nome do projeto
- fileName
-
string
nome de ficheiro do item devolvido.
- download
-
boolean
Se for verdadeiro, crie um anexo transferível.
- scopePath
-
string
Caminho de controlo de versão de uma pasta para devolver vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versões. A predefinição é nula.
- includeContent
-
boolean
Defina como verdadeiro para incluir conteúdo do item ao pedir json. A predefinição é falso.
Devoluções
Promise<string>
getItemZip(string, string, string, boolean, string, VersionControlRecursionType, TfvcVersionDescriptor, boolean)
Obter Metadados de Itens e/ou Conteúdo para um único item. O parâmetro de transferência é para indicar se o conteúdo deve estar disponível como transferência ou apenas enviado como um fluxo na resposta. Não se aplica ao conteúdo zipado que é sempre devolvido como uma transferência.
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 controlo de versão de um item individual a devolver.
- project
-
string
ID do Projeto ou nome do projeto
- fileName
-
string
nome de ficheiro do item devolvido.
- download
-
boolean
Se for verdadeiro, crie um anexo transferível.
- scopePath
-
string
Caminho de controlo de versão de uma pasta para devolver vários itens.
- recursionLevel
- VersionControlRecursionType
Nenhum (apenas o item) ou OneLevel (conteúdo de uma pasta).
- versionDescriptor
- TfvcVersionDescriptor
Descritor de versões. A predefinição é nula.
- includeContent
-
boolean
Defina como verdadeiro para incluir conteúdo de item ao pedir json. A predefinição é falso.
Devoluções
Promise<ArrayBuffer>
getLabel(string, TfvcLabelRequestData, string)
Obtenha uma única etiqueta profunda.
function getLabel(labelId: string, requestData: TfvcLabelRequestData, project?: string): Promise<TfvcLabel>Parâmetros
- labelId
-
string
Identificador exclusivo da etiqueta
- requestData
- TfvcLabelRequestData
maxItemCount
- project
-
string
ID do Projeto ou nome do projeto
Devoluções
Promise<TfvcLabel>
getLabelItems(string, number, number)
Obter itens numa etiqueta.
function getLabelItems(labelId: string, top?: number, skip?: number): Promise<TfvcItem[]>Parâmetros
- labelId
-
string
Identificador exclusivo da etiqueta
- top
-
number
Número máximo de itens a devolver
- skip
-
number
Número de itens a ignorar
Devoluções
Promise<TfvcItem[]>
getLabels(TfvcLabelRequestData, string, number, number)
Obtenha uma coleção de referências de etiquetas rasas.
function getLabels(requestData: TfvcLabelRequestData, project?: string, top?: number, skip?: number): Promise<TfvcLabelRef[]>Parâmetros
- requestData
- TfvcLabelRequestData
labelScope, name, owner e itemLabelFilter
- project
-
string
ID do Projeto ou nome do projeto
- top
-
number
Número máximo de etiquetas a devolver, predefinição para 100 quando não definido
- skip
-
number
Número de etiquetas a ignorar
Devoluções
Promise<TfvcLabelRef[]>
getShelveset(string, TfvcShelvesetRequestData)
Obter uma única prateleira profunda.
function getShelveset(shelvesetId: string, requestData?: TfvcShelvesetRequestData): Promise<TfvcShelveset>Parâmetros
- shelvesetId
-
string
ID exclusivo do Shelveset
- requestData
- TfvcShelvesetRequestData
includeDetails, includeWorkItems, maxChangeCount e maxCommentLength
Devoluções
Promise<TfvcShelveset>
getShelvesetChanges(string, number, number)
Obter alterações incluídas num conjunto de prateleiras.
function getShelvesetChanges(shelvesetId: string, top?: number, skip?: number): Promise<TfvcChange[]>Parâmetros
- shelvesetId
-
string
ID exclusivo do 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)
Devolver uma coleção de referências de conjuntos de prateleiras rasas.
function getShelvesets(requestData?: TfvcShelvesetRequestData, top?: number, skip?: number): Promise<TfvcShelvesetRef[]>Parâmetros
- requestData
- TfvcShelvesetRequestData
name, owner e maxCommentLength
- top
-
number
Número máximo de conjuntos de prateleiras a devolver
- skip
-
number
Número de conjuntos de prateleiras a ignorar
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 do Shelveset
Devoluções
Promise<AssociatedWorkItem[]>
getTfvcStatistics(string, string)
Fornece a Contagem de Ficheiros e Bytes Não Comprimidos para uma Coleção/Projeto num âmbito 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, "$/project" para um projeto específico
Devoluções
Promise<TfvcStatistics>