Partager via


WikiRestClient class

Classe de base qui doit être utilisée (dérivée de) pour effectuer des requêtes à des api REST VSS

Extends

Constructeurs

WikiRestClient(IVssRestClientOptions)

Propriétés

RESOURCE_AREA_ID

Méthodes

addComment(CommentCreateParameters, string, string, number)

Ajouter un commentaire sur une page wiki.

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

Ajouter une réaction sur un commentaire de page wiki.

createCommentAttachment(any, string, string, number)

Charge une pièce jointe sur un commentaire sur une page wiki.

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

Crée une ressource de statistiques d’affichage de page ou met à jour une ressource de statistiques d’affichage de page existante.

createWiki(WikiCreateParametersV2, string)

Crée la ressource wiki.

deleteComment(string, string, number, number)

Supprimer un commentaire sur une page wiki.

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

Supprimer une réaction sur un commentaire de page wiki.

deleteWiki(string, string)

Supprime le wiki correspondant à l’ID wiki ou au nom de wiki fourni.

getAllWikis(string)

Obtient tous les wikis d’un projet ou d’une collection.

getAttachmentContent(string, string, number, string)

Télécharge une pièce jointe sur un commentaire sur une page wiki.

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

Retourne un commentaire associé à la page Wiki.

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

Obtient la liste des utilisateurs qui ont réagi pour le commentaire wiki donné avec un type de réaction donné. Prend en charge la pagination, avec une taille de page par défaut de 100 utilisateurs à la fois.

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

Obtient les métadonnées ou le contenu de la page wiki pour l’ID de page fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

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

Obtient les métadonnées ou le contenu de la page wiki pour l’ID de page fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

getPageData(string, string, number, number)

Retourne le détail de la page correspondant à l’ID de page.

getPagesBatch(WikiPagesBatchRequest, string, string, GitVersionDescriptor)

Retourne la liste paginable des pages Wiki

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

Obtient les métadonnées ou le contenu de la page wiki pour le chemin d’accès fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

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

Obtient les métadonnées ou le contenu de la page wiki pour le chemin d’accès fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

getWiki(string, string)

Obtient le wiki correspondant à l’ID wiki ou au nom wiki fourni.

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

Retourne une liste de commentaires paginable.

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

Mettre à jour un commentaire sur une page wiki.

updateWiki(WikiUpdateParameters, string, string)

Mises à jour le wiki correspondant à l’ID wiki ou au nom du wiki fourni à l’aide des paramètres de mise à jour.

Détails du constructeur

WikiRestClient(IVssRestClientOptions)

new WikiRestClient(options: IVssRestClientOptions)

Paramètres

Détails de la propriété

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Valeur de propriété

string

Détails de la méthode

addComment(CommentCreateParameters, string, string, number)

Ajouter un commentaire sur une page wiki.

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

Paramètres

request
CommentCreateParameters

Demande de création de commentaire.

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID du wiki ou nom du wiki.

pageId

number

ID de page wiki.

Retours

Promise<Comment>

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

Ajouter une réaction sur un commentaire de page wiki.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID du wiki ou nom du wiki

pageId

number

Wiki page ID

commentId

number

ID du commentaire associé

type
CommentReactionType

Type de la réaction ajoutée

Retours

Promise<CommentReaction>

createCommentAttachment(any, string, string, number)

Charge une pièce jointe sur un commentaire sur une page wiki.

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

Paramètres

content

any

Contenu à charger

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID du wiki ou nom du wiki.

pageId

number

ID de page wiki.

Retours

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

Crée une ressource de statistiques d’affichage de page ou met à jour une ressource de statistiques d’affichage de page existante.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID du wiki ou nom du wiki.

wikiVersion
GitVersionDescriptor

Version du wiki.

path

string

Chemin d’accès à la page Wiki.

oldPath

string

Ancien chemin d’accès à la page. Cette option est facultative et nécessaire pour renommer le chemin d’accès dans les statistiques d’affichage de page existantes.

Retours

createWiki(WikiCreateParametersV2, string)

Crée la ressource wiki.

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

Paramètres

wikiCreateParams
WikiCreateParametersV2

Paramètres pour la création du wiki.

project

string

ID de projet ou nom du projet

Retours

Promise<WikiV2>

deleteComment(string, string, number, number)

Supprimer un commentaire sur une page wiki.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID ou nom du wiki.

pageId

number

ID de page wiki.

id

number

ID de commentaire.

Retours

Promise<void>

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

Supprimer une réaction sur un commentaire de page wiki.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID ou nom du wiki

pageId

number

Wiki page ID

commentId

number

ID du commentaire associé

type
CommentReactionType

Type de la réaction en cours de suppression

Retours

Promise<CommentReaction>

deleteWiki(string, string)

Supprime le wiki correspondant à l’ID wiki ou au nom de wiki fourni.

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

Paramètres

wikiIdentifier

string

ID du wiki ou nom du wiki.

project

string

ID de projet ou nom du projet

Retours

Promise<WikiV2>

getAllWikis(string)

Obtient tous les wikis d’un projet ou d’une collection.

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

Paramètres

project

string

ID de projet ou nom du projet

Retours

Promise<WikiV2[]>

getAttachmentContent(string, string, number, string)

Télécharge une pièce jointe sur un commentaire sur une page wiki.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID du wiki ou nom du wiki.

pageId

number

ID de page wiki.

attachmentId

string

ID de pièce jointe.

Retours

Promise<ArrayBuffer>

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

Retourne un commentaire associé à la page Wiki.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

pageId

number

ID de page Wiki.

id

number

ID du commentaire à retourner.

excludeDeleted

boolean

Spécifiez si le commentaire supprimé doit être ignoré.

expand
CommentExpandOptions

Spécifie les options de récupération de données supplémentaires pour les commentaires.

Retours

Promise<Comment>

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

Obtient la liste des utilisateurs qui ont réagi pour le commentaire wiki donné avec un type de réaction donné. Prend en charge la pagination, avec une taille de page par défaut de 100 utilisateurs à la fois.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

pageId

number

ID de page Wiki.

commentId

number

ID du commentaire associé

type
CommentReactionType

Type de la réaction pour laquelle les utilisateurs engagés sont demandés

top

number

Nombre d’utilisateurs enagés à retourner dans une page donnée. Facultatif, la valeur par défaut est 100

skip

number

Nombre d’utilisateurs engagés à ignorer pour pager l’ensemble d’utilisateurs engagés suivant, la valeur par défaut est 0

Retours

Promise<IdentityRef[]>

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

Obtient les métadonnées ou le contenu de la page wiki pour l’ID de page fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki..

id

number

ID de page Wiki.

recursionLevel
VersionControlRecursionType

Niveau de récursivité pour la récupération des sous-pages. La valeur par défaut est None (Facultatif).

includeContent

boolean

True pour inclure le contenu de la page dans la réponse pour le type de contenu Json. La valeur par défaut est false (Facultatif)

Retours

Promise<string>

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

Obtient les métadonnées ou le contenu de la page wiki pour l’ID de page fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki..

id

number

ID de page Wiki.

recursionLevel
VersionControlRecursionType

Niveau de récursivité pour la récupération des sous-pages. La valeur par défaut est None (Facultatif).

includeContent

boolean

True pour inclure le contenu de la page dans la réponse pour le type de contenu Json. La valeur par défaut est false (Facultatif)

Retours

Promise<ArrayBuffer>

getPageData(string, string, number, number)

Retourne le détail de la page correspondant à l’ID de page.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

pageId

number

ID de page Wiki.

pageViewsForDays

number

N derniers jours à compter du jour actuel pour lequel les vues de page doivent être retournées. Il est inclus dans la journée actuelle.

Retours

Promise<WikiPageDetail>

getPagesBatch(WikiPagesBatchRequest, string, string, GitVersionDescriptor)

Retourne la liste paginable des pages Wiki

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

Paramètres

pagesBatchRequest
WikiPagesBatchRequest

Demande de page de lot Wiki.

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

versionDescriptor
GitVersionDescriptor

GitVersionDescriptor pour la page. (Facultatif dans le cas de ProjectWiki).

Retours

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

Obtient les métadonnées ou le contenu de la page wiki pour le chemin d’accès fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

path

string

Chemin d’accès à la page Wiki.

recursionLevel
VersionControlRecursionType

Niveau de récursivité pour la récupération des sous-pages. La valeur par défaut est None (Facultatif).

versionDescriptor
GitVersionDescriptor

GitVersionDescriptor pour la page. Par défaut, le branche par défaut (facultatif).

includeContent

boolean

True pour inclure le contenu de la page dans la réponse pour le type de contenu Json. La valeur par défaut est false (Facultatif)

Retours

Promise<string>

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

Obtient les métadonnées ou le contenu de la page wiki pour le chemin d’accès fourni. La négociation du contenu est effectuée en fonction de l’en-tête Accept envoyé dans la demande.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

path

string

Chemin d’accès à la page Wiki.

recursionLevel
VersionControlRecursionType

Niveau de récursivité pour la récupération des sous-pages. La valeur par défaut est None (Facultatif).

versionDescriptor
GitVersionDescriptor

GitVersionDescriptor pour la page. Par défaut, le branche par défaut (facultatif).

includeContent

boolean

True pour inclure le contenu de la page dans la réponse pour le type de contenu Json. La valeur par défaut est false (Facultatif)

Retours

Promise<ArrayBuffer>

getWiki(string, string)

Obtient le wiki correspondant à l’ID wiki ou au nom wiki fourni.

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

Paramètres

wikiIdentifier

string

ID wiki ou nom du wiki.

project

string

ID de projet ou nom du projet

Retours

Promise<WikiV2>

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

Retourne une liste de commentaires paginable.

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

Paramètres

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

pageId

number

ID de page Wiki.

top

number

Nombre maximal de commentaires à retourner.

continuationToken

string

Utilisé pour interroger la page de commentaires suivante.

excludeDeleted

boolean

Spécifiez si les commentaires supprimés doivent être ignorés.

expand
CommentExpandOptions

Spécifie les options de récupération de données supplémentaires pour les commentaires.

order
CommentSortOrder

Ordre dans lequel les commentaires doivent être retournés.

parentId

number

CommentId du commentaire parent.

Retours

Promise<CommentList>

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

Mettre à jour un commentaire sur une page wiki.

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

Paramètres

comment
CommentUpdateParameters

Demande de mise à jour des commentaires.

project

string

ID de projet ou nom du projet

wikiIdentifier

string

ID wiki ou nom du wiki.

pageId

number

ID de page Wiki.

id

number

ID de commentaire.

Retours

Promise<Comment>

updateWiki(WikiUpdateParameters, string, string)

Mises à jour le wiki correspondant à l’ID wiki ou au nom du wiki fourni à l’aide des paramètres de mise à jour.

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

Paramètres

updateParameters
WikiUpdateParameters

Mettre à jour les paramètres.

wikiIdentifier

string

ID wiki ou nom du wiki.

project

string

ID de projet ou nom du projet

Retours

Promise<WikiV2>