Condividi tramite


WikiRestClient class

Classe di base da usare (derivata da) per effettuare richieste alle API REST vss

Extends

Costruttori

WikiRestClient(IVssRestClientOptions)

Proprietà

RESOURCE_AREA_ID

Metodi

addComment(CommentCreateParameters, string, string, number)

Aggiungi un commento su una pagina wiki.

addCommentReaction(string, string, number, number, CommentReactionType)

Aggiungi una reazione a un commento su una pagina wiki.

createCommentAttachment(any, string, string, number)

Carica un allegato su un commento su una pagina wiki.

createOrUpdatePageViewStats(string, string, GitVersionDescriptor, string, string)

Crea una nuova risorsa per le statistiche delle visualizzazioni di pagina o aggiorna una risorsa per le statistiche delle visualizzazioni di pagina esistente.

createWiki(WikiCreateParametersV2, string)

Crea la risorsa wiki.

deleteComment(string, string, number, number)

Elimina un commento su una pagina wiki.

deleteCommentReaction(string, string, number, number, CommentReactionType)

Elimina una reazione su un commento di una pagina wiki.

deleteWiki(string, string)

Elimina il wiki corrispondente all'ID wiki o al nome wiki fornito.

getAllWikis(string)

Ottiene tutte le wiki in un progetto o in una raccolta.

getAttachmentContent(string, string, number, string)

Scarica un allegato su un commento su una pagina wiki.

getComment(string, string, number, number, boolean, CommentExpandOptions)

Restituisce un commento associato alla pagina Wiki.

getEngagedUsers(string, string, number, number, CommentReactionType, number, number)

Ottiene un elenco di utenti che hanno reagito per un dato commento wiki con un dato tipo di reazione. Supporta il paging, con una dimensione di pagina predefinita di 100 utenti alla volta.

getPageByIdText(string, string, number, VersionControlRecursionType, boolean)

Ottiene i metadati o il contenuto della pagina wiki per l'ID pagina fornito. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

getPageByIdZip(string, string, number, VersionControlRecursionType, boolean)

Ottiene i metadati o il contenuto della pagina wiki per l'ID pagina fornito. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

getPageData(string, string, number, number)

Restituisce i dettagli della pagina corrispondenti all'ID pagina.

getPagesBatch(WikiPagesBatchRequest, string, string, GitVersionDescriptor)

Restituisce un elenco paginabile di pagine Wiki

getPageText(string, string, string, VersionControlRecursionType, GitVersionDescriptor, boolean)

Ottiene i metadati o il contenuto della pagina wiki per il percorso specificato. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

getPageZip(string, string, string, VersionControlRecursionType, GitVersionDescriptor, boolean)

Ottiene i metadati o il contenuto della pagina wiki per il percorso specificato. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

getWiki(string, string)

Ottiene il wiki corrispondente all'ID wiki o al nome wiki fornito.

listComments(string, string, number, number, string, boolean, CommentExpandOptions, CommentSortOrder, number)

Restituisce un elenco di commenti paginabile.

updateComment(CommentUpdateParameters, string, string, number, number)

Aggiorna un commento su una pagina wiki.

updateWiki(WikiUpdateParameters, string, string)

Aggiorna il wiki corrispondente all'ID wiki o al nome wiki fornito utilizzando i parametri di aggiornamento.

Dettagli costruttore

WikiRestClient(IVssRestClientOptions)

new WikiRestClient(options: IVssRestClientOptions)

Parametri

Dettagli proprietà

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Valore della proprietà

string

Dettagli metodo

addComment(CommentCreateParameters, string, string, number)

Aggiungi un commento su una pagina wiki.

function addComment(request: CommentCreateParameters, project: string, wikiIdentifier: string, pageId: number): Promise<Comment>

Parametri

request
CommentCreateParameters

Richiesta di creazione di commenti.

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

Restituisce

Promise<Comment>

addCommentReaction(string, string, number, number, CommentReactionType)

Aggiungi una reazione a un commento su una pagina wiki.

function addCommentReaction(project: string, wikiIdentifier: string, pageId: number, commentId: number, type: CommentReactionType): Promise<CommentReaction>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki

pageId

number

ID pagina wiki

commentId

number

ID del commento associato

type
CommentReactionType

Tipo di reazione da aggiungere

Restituisce

Promise<CommentReaction>

createCommentAttachment(any, string, string, number)

Carica un allegato su un commento su una pagina wiki.

function createCommentAttachment(content: any, project: string, wikiIdentifier: string, pageId: number): Promise<CommentAttachment>

Parametri

content

any

Contenuto da caricare

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

Restituisce

createOrUpdatePageViewStats(string, string, GitVersionDescriptor, string, string)

Crea una nuova risorsa per le statistiche delle visualizzazioni di pagina o aggiorna una risorsa per le statistiche delle visualizzazioni di pagina esistente.

function createOrUpdatePageViewStats(project: string, wikiIdentifier: string, wikiVersion: GitVersionDescriptor, path: string, oldPath?: string): Promise<WikiPageViewStats>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

wikiVersion
GitVersionDescriptor

Versione Wiki.

path

string

Percorso della pagina wiki.

oldPath

string

Vecchio percorso di pagina. Questa opzione è facoltativa e necessaria per rinominare il percorso nelle statistiche di visualizzazione pagina esistenti.

Restituisce

createWiki(WikiCreateParametersV2, string)

Crea la risorsa wiki.

function createWiki(wikiCreateParams: WikiCreateParametersV2, project?: string): Promise<WikiV2>

Parametri

wikiCreateParams
WikiCreateParametersV2

Parametri per la creazione del wiki.

project

string

ID progetto o nome progetto

Restituisce

Promise<WikiV2>

deleteComment(string, string, number, number)

Elimina un commento su una pagina wiki.

function deleteComment(project: string, wikiIdentifier: string, pageId: number, id: number): Promise<void>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome.

pageId

number

ID pagina wiki.

id

number

ID commento.

Restituisce

Promise<void>

deleteCommentReaction(string, string, number, number, CommentReactionType)

Elimina una reazione su un commento di una pagina wiki.

function deleteCommentReaction(project: string, wikiIdentifier: string, pageId: number, commentId: number, type: CommentReactionType): Promise<CommentReaction>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID o nome wiki

pageId

number

ID pagina wiki

commentId

number

ID del commento associato

type
CommentReactionType

Tipo di reazione da eliminare

Restituisce

Promise<CommentReaction>

deleteWiki(string, string)

Elimina il wiki corrispondente all'ID wiki o al nome wiki fornito.

function deleteWiki(wikiIdentifier: string, project?: string): Promise<WikiV2>

Parametri

wikiIdentifier

string

ID wiki o nome wiki.

project

string

ID progetto o nome progetto

Restituisce

Promise<WikiV2>

getAllWikis(string)

Ottiene tutte le wiki in un progetto o in una raccolta.

function getAllWikis(project?: string): Promise<WikiV2[]>

Parametri

project

string

ID progetto o nome progetto

Restituisce

Promise<WikiV2[]>

getAttachmentContent(string, string, number, string)

Scarica un allegato su un commento su una pagina wiki.

function getAttachmentContent(project: string, wikiIdentifier: string, pageId: number, attachmentId: string): Promise<ArrayBuffer>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

attachmentId

string

ID allegato.

Restituisce

Promise<ArrayBuffer>

getComment(string, string, number, number, boolean, CommentExpandOptions)

Restituisce un commento associato alla pagina Wiki.

function getComment(project: string, wikiIdentifier: string, pageId: number, id: number, excludeDeleted?: boolean, expand?: CommentExpandOptions): Promise<Comment>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

id

number

ID del commento da restituire.

excludeDeleted

boolean

Specificare se il commento eliminato deve essere saltato.

expand
CommentExpandOptions

Specifica le opzioni aggiuntive di recupero dei dati per i commenti.

Restituisce

Promise<Comment>

getEngagedUsers(string, string, number, number, CommentReactionType, number, number)

Ottiene un elenco di utenti che hanno reagito per un dato commento wiki con un dato tipo di reazione. Supporta il paging, con una dimensione di pagina predefinita di 100 utenti alla volta.

function getEngagedUsers(project: string, wikiIdentifier: string, pageId: number, commentId: number, type: CommentReactionType, top?: number, skip?: number): Promise<IdentityRef[]>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

commentId

number

ID del commento associato

type
CommentReactionType

Tipo di reazione per la quale vengono richiesti gli utenti coinvolti

top

number

Numero di utenti coinvolti da restituire in una determinata pagina. Facoltativo, il valore predefinito è 100

skip

number

Il numero di utenti coinvolti da passare alla pagina successiva del set di utenti coinvolti, il valore predefinito è 0

Restituisce

Promise<IdentityRef[]>

getPageByIdText(string, string, number, VersionControlRecursionType, boolean)

Ottiene i metadati o il contenuto della pagina wiki per l'ID pagina fornito. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

function getPageByIdText(project: string, wikiIdentifier: string, id: number, recursionLevel?: VersionControlRecursionType, includeContent?: boolean): Promise<string>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

Wiki ID o nome wiki..

id

number

ID pagina wiki.

recursionLevel
VersionControlRecursionType

Livello di ricorsione per il recupero delle sottopagine. Il valore predefinito è None (facoltativo).

includeContent

boolean

True per includere il contenuto della pagina nella risposta per il tipo di contenuto Json. Il valore predefinito è false (facoltativo)

Restituisce

Promise<string>

getPageByIdZip(string, string, number, VersionControlRecursionType, boolean)

Ottiene i metadati o il contenuto della pagina wiki per l'ID pagina fornito. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

function getPageByIdZip(project: string, wikiIdentifier: string, id: number, recursionLevel?: VersionControlRecursionType, includeContent?: boolean): Promise<ArrayBuffer>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

Wiki ID o nome wiki..

id

number

ID pagina wiki.

recursionLevel
VersionControlRecursionType

Livello di ricorsione per il recupero delle sottopagine. Il valore predefinito è None (facoltativo).

includeContent

boolean

True per includere il contenuto della pagina nella risposta per il tipo di contenuto Json. Il valore predefinito è false (facoltativo)

Restituisce

Promise<ArrayBuffer>

getPageData(string, string, number, number)

Restituisce i dettagli della pagina corrispondenti all'ID pagina.

function getPageData(project: string, wikiIdentifier: string, pageId: number, pageViewsForDays?: number): Promise<WikiPageDetail>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

pageViewsForDays

number

ultimi N giorni dal giorno corrente per il quale devono essere restituite le visualizzazioni di pagina. È comprensivo dei giorni nostri.

Restituisce

Promise<WikiPageDetail>

getPagesBatch(WikiPagesBatchRequest, string, string, GitVersionDescriptor)

Restituisce un elenco paginabile di pagine Wiki

function getPagesBatch(pagesBatchRequest: WikiPagesBatchRequest, project: string, wikiIdentifier: string, versionDescriptor?: GitVersionDescriptor): Promise<PagedList<WikiPageDetail>>

Parametri

pagesBatchRequest
WikiPagesBatchRequest

Richiesta di pagina batch wiki.

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

versionDescriptor
GitVersionDescriptor

GitVersionDescriptor per la pagina. (Facoltativo nel caso di ProjectWiki).

Restituisce

getPageText(string, string, string, VersionControlRecursionType, GitVersionDescriptor, boolean)

Ottiene i metadati o il contenuto della pagina wiki per il percorso specificato. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

function getPageText(project: string, wikiIdentifier: string, path?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean): Promise<string>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

path

string

Percorso della pagina wiki.

recursionLevel
VersionControlRecursionType

Livello di ricorsione per il recupero delle sottopagine. Il valore predefinito è None (facoltativo).

versionDescriptor
GitVersionDescriptor

GitVersionDescriptor per la pagina. Il valore predefinito è il ramo predefinito (facoltativo).

includeContent

boolean

True per includere il contenuto della pagina nella risposta per il tipo di contenuto Json. Il valore predefinito è false (facoltativo)

Restituisce

Promise<string>

getPageZip(string, string, string, VersionControlRecursionType, GitVersionDescriptor, boolean)

Ottiene i metadati o il contenuto della pagina wiki per il percorso specificato. La negoziazione del contenuto viene eseguita in base all'intestazione Accept inviata nella richiesta.

function getPageZip(project: string, wikiIdentifier: string, path?: string, recursionLevel?: VersionControlRecursionType, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean): Promise<ArrayBuffer>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

path

string

Percorso della pagina wiki.

recursionLevel
VersionControlRecursionType

Livello di ricorsione per il recupero delle sottopagine. Il valore predefinito è None (facoltativo).

versionDescriptor
GitVersionDescriptor

GitVersionDescriptor per la pagina. Il valore predefinito è il ramo predefinito (facoltativo).

includeContent

boolean

True per includere il contenuto della pagina nella risposta per il tipo di contenuto Json. Il valore predefinito è false (facoltativo)

Restituisce

Promise<ArrayBuffer>

getWiki(string, string)

Ottiene il wiki corrispondente all'ID wiki o al nome wiki fornito.

function getWiki(wikiIdentifier: string, project?: string): Promise<WikiV2>

Parametri

wikiIdentifier

string

ID wiki o nome wiki.

project

string

ID progetto o nome progetto

Restituisce

Promise<WikiV2>

listComments(string, string, number, number, string, boolean, CommentExpandOptions, CommentSortOrder, number)

Restituisce un elenco di commenti paginabile.

function listComments(project: string, wikiIdentifier: string, pageId: number, top?: number, continuationToken?: string, excludeDeleted?: boolean, expand?: CommentExpandOptions, order?: CommentSortOrder, parentId?: number): Promise<CommentList>

Parametri

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

top

number

Numero massimo di commenti da restituire.

continuationToken

string

Utilizzato per eseguire una query per la pagina successiva di commenti.

excludeDeleted

boolean

Specificare se i commenti eliminati devono essere ignorati.

expand
CommentExpandOptions

Specifica le opzioni aggiuntive di recupero dei dati per i commenti.

order
CommentSortOrder

Ordine in cui devono essere restituiti i commenti.

parentId

number

CommentId del commento padre.

Restituisce

Promise<CommentList>

updateComment(CommentUpdateParameters, string, string, number, number)

Aggiorna un commento su una pagina wiki.

function updateComment(comment: CommentUpdateParameters, project: string, wikiIdentifier: string, pageId: number, id: number): Promise<Comment>

Parametri

comment
CommentUpdateParameters

Richiesta di aggiornamento dei commenti.

project

string

ID progetto o nome progetto

wikiIdentifier

string

ID wiki o nome wiki.

pageId

number

ID pagina wiki.

id

number

ID commento.

Restituisce

Promise<Comment>

updateWiki(WikiUpdateParameters, string, string)

Aggiorna il wiki corrispondente all'ID wiki o al nome wiki fornito utilizzando i parametri di aggiornamento.

function updateWiki(updateParameters: WikiUpdateParameters, wikiIdentifier: string, project?: string): Promise<WikiV2>

Parametri

updateParameters
WikiUpdateParameters

Aggiornare i parametri.

wikiIdentifier

string

ID wiki o nome wiki.

project

string

ID progetto o nome progetto

Restituisce

Promise<WikiV2>