WikiRestClient class

应使用基类(派生自)向 VSS REST API 发出请求

扩展

构造函数

WikiRestClient(IVssRestClientOptions)

属性

RESOURCE_AREA_ID

方法

addComment(CommentCreateParameters, string, string, number)

在 Wiki 页面上添加注释。

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

在 Wiki 页面批注中添加反应。

createCommentAttachment(any, string, string, number)

在 Wiki 页面上的批注中上传附件。

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

创建新的页面视图统计信息资源或更新现有页面视图统计信息资源。

createWiki(WikiCreateParametersV2, string)

创建 Wiki 资源。

deleteComment(string, string, number, number)

删除 Wiki 页面上的注释。

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

删除 Wiki 页面批注中的反应。

deleteWiki(string, string)

删除与提供的 Wiki ID 或 Wiki 名称对应的 Wiki。

getAllWikis(string)

获取项目或集合中的所有 Wiki。

getAttachmentContent(string, string, number, string)

在 Wiki 页面上的批注中下载附件。

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

返回与 Wiki 页面关联的注释。

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

获取使用给定反应类型为给定 Wiki 注释做出反应的用户的列表。 支持分页,默认页面大小一次为 100 个用户。

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

获取所提供页面 ID 的 Wiki 页面的元数据或内容。内容协商是根据请求中发送的 Accept 标头完成的。

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

获取所提供页面 ID 的 Wiki 页面的元数据或内容。内容协商是根据请求中发送的 Accept 标头完成的。

getPageData(string, string, number, number)

返回对应于页面 ID 的页面详细信息。

getPagesBatch(WikiPagesBatchRequest, string, string, GitVersionDescriptor)

返回 Wiki 页面的可分页列表

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

获取提供的路径的 Wiki 页面的元数据或内容。 内容协商是根据请求中发送的 Accept 标头完成的。

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

获取提供的路径的 Wiki 页面的元数据或内容。 内容协商是根据请求中发送的 Accept 标头完成的。

getWiki(string, string)

获取与提供的 Wiki ID 或 Wiki 名称对应的 Wiki。

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

返回可分页的批注列表。

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

更新 Wiki 页面上的注释。

updateWiki(WikiUpdateParameters, string, string)

更新与使用更新参数提供的 Wiki ID 或 Wiki 名称对应的 Wiki。

构造函数详细信息

WikiRestClient(IVssRestClientOptions)

new WikiRestClient(options: IVssRestClientOptions)

参数

属性详细信息

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

属性值

string

方法详细信息

addComment(CommentCreateParameters, string, string, number)

在 Wiki 页面上添加注释。

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

参数

request
CommentCreateParameters

注释创建请求。

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

返回

Promise<Comment>

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

在 Wiki 页面批注中添加反应。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称

pageId

number

Wiki 页面 ID

commentId

number

关联的注释的 ID

type
CommentReactionType

正在添加的反应的类型

返回

Promise<CommentReaction>

createCommentAttachment(any, string, string, number)

在 Wiki 页面上的批注中上传附件。

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

参数

content

any

要上传的内容

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

返回

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

创建新的页面视图统计信息资源或更新现有页面视图统计信息资源。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

wikiVersion
GitVersionDescriptor

Wiki 版本。

path

string

Wiki 页面路径。

oldPath

string

旧页面路径。 这是可选的,需要在现有页面视图统计信息中重命名路径。

返回

createWiki(WikiCreateParametersV2, string)

创建 Wiki 资源。

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

参数

wikiCreateParams
WikiCreateParametersV2

Wiki 创建的参数。

project

string

项目 ID 或项目名称

返回

Promise<WikiV2>

deleteComment(string, string, number, number)

删除 Wiki 页面上的注释。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或名称。

pageId

number

Wiki 页面 ID。

id

number

注释 ID。

返回

Promise<void>

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

删除 Wiki 页面批注中的反应。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或名称

pageId

number

Wiki 页面 ID

commentId

number

关联的注释的 ID

type
CommentReactionType

正在删除的反应的类型

返回

Promise<CommentReaction>

deleteWiki(string, string)

删除与提供的 Wiki ID 或 Wiki 名称对应的 Wiki。

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

参数

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

project

string

项目 ID 或项目名称

返回

Promise<WikiV2>

getAllWikis(string)

获取项目或集合中的所有 Wiki。

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

参数

project

string

项目 ID 或项目名称

返回

Promise<WikiV2[]>

getAttachmentContent(string, string, number, string)

在 Wiki 页面上的批注中下载附件。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

attachmentId

string

附件 ID。

返回

Promise<ArrayBuffer>

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

返回与 Wiki 页面关联的注释。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

id

number

要返回的注释的 ID。

excludeDeleted

boolean

指定是否应跳过已删除的注释。

expand
CommentExpandOptions

指定注释的其他数据检索选项。

返回

Promise<Comment>

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

获取使用给定反应类型为给定 Wiki 注释做出反应的用户的列表。 支持分页,默认页面大小一次为 100 个用户。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

commentId

number

关联的注释的 ID

type
CommentReactionType

请求参与用户的反应的类型

top

number

在给定页面中返回的已加密用户数。 可选,默认值为 100

skip

number

要跳过到页面的已参与用户数,下一组参与用户,默认为 0

返回

Promise<IdentityRef[]>

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

获取所提供页面 ID 的 Wiki 页面的元数据或内容。内容协商是根据请求中发送的 Accept 标头完成的。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 wiki 名称。。

id

number

Wiki 页面 ID。

recursionLevel
VersionControlRecursionType

子页检索的递归级别。 默认为 None (可选)。

includeContent

boolean

如果为 True,请在 Json 内容类型的响应中包含页面的内容。 默认值为 false (可选)

返回

Promise<string>

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

获取所提供页面 ID 的 Wiki 页面的元数据或内容。内容协商是根据请求中发送的 Accept 标头完成的。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 wiki 名称。。

id

number

Wiki 页面 ID。

recursionLevel
VersionControlRecursionType

子页检索的递归级别。 默认为 None (可选)。

includeContent

boolean

如果为 True,请在 Json 内容类型的响应中包含页面的内容。 默认值为 false (可选)

返回

Promise<ArrayBuffer>

getPageData(string, string, number, number)

返回对应于页面 ID 的页面详细信息。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

pageViewsForDays

number

要返回页面视图的当前日期的最后 N 天。 它包括当前一天。

返回

Promise<WikiPageDetail>

getPagesBatch(WikiPagesBatchRequest, string, string, GitVersionDescriptor)

返回 Wiki 页面的可分页列表

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

参数

pagesBatchRequest
WikiPagesBatchRequest

Wiki 批处理页请求。

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

versionDescriptor
GitVersionDescriptor

页面的 GitVersionDescriptor。 (可选,对于 ProjectWiki)。

返回

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

获取提供的路径的 Wiki 页面的元数据或内容。 内容协商是根据请求中发送的 Accept 标头完成的。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

path

string

Wiki 页面路径。

recursionLevel
VersionControlRecursionType

子页检索的递归级别。 默认为 None (可选)。

versionDescriptor
GitVersionDescriptor

页面的 GitVersionDescriptor。 默认为默认分支(可选)。

includeContent

boolean

如果为 True,请在 Json 内容类型的响应中包含页面的内容。 默认值为 false (可选)

返回

Promise<string>

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

获取提供的路径的 Wiki 页面的元数据或内容。 内容协商是根据请求中发送的 Accept 标头完成的。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

path

string

Wiki 页面路径。

recursionLevel
VersionControlRecursionType

子页检索的递归级别。 默认为 None (可选)。

versionDescriptor
GitVersionDescriptor

页面的 GitVersionDescriptor。 默认为默认分支(可选)。

includeContent

boolean

如果为 True,请在 Json 内容类型的响应中包含页面的内容。 默认值为 false (可选)

返回

Promise<ArrayBuffer>

getWiki(string, string)

获取与提供的 Wiki ID 或 Wiki 名称对应的 Wiki。

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

参数

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

project

string

项目 ID 或项目名称

返回

Promise<WikiV2>

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

返回可分页的批注列表。

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

参数

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

top

number

要返回的最大批注数。

continuationToken

string

用于查询下一页批注。

excludeDeleted

boolean

指定是否应跳过已删除的注释。

expand
CommentExpandOptions

指定注释的其他数据检索选项。

order
CommentSortOrder

应返回批注的顺序。

parentId

number

父注释的 CommentId。

返回

Promise<CommentList>

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

更新 Wiki 页面上的注释。

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

参数

comment
CommentUpdateParameters

注释更新请求。

project

string

项目 ID 或项目名称

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

pageId

number

Wiki 页面 ID。

id

number

注释 ID。

返回

Promise<Comment>

updateWiki(WikiUpdateParameters, string, string)

更新与使用更新参数提供的 Wiki ID 或 Wiki 名称对应的 Wiki。

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

参数

updateParameters
WikiUpdateParameters

更新参数。

wikiIdentifier

string

Wiki ID 或 Wiki 名称。

project

string

项目 ID 或项目名称

返回

Promise<WikiV2>