Jira Service Management

使用说明

集成 Jira Service Management 以进行 IT 服务管理。可创建和管理服务请求，处理客户和组织，跟踪 SLA，并管理队列。

工具

`jsm_get_service_desks`

获取 Jira Service Management 中的所有服务台

输入

参数	类型	必填	说明
`domain`	string	是	你的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`start`	number	否	分页起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`serviceDesks`	json	服务台数组
`total`	number	服务台总数
`isLastPage`	boolean	是否为最后一页

`jsm_get_request_types`

获取 Jira Service Management 中某个服务台的请求类型

输入

参数	类型	必填	说明
`domain`	string	是	你的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要获取请求类型的服务台 ID
`start`	number	否	分页起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`requestTypes`	json	请求类型的数组
`total`	number	请求类型的总数
`isLastPage`	boolean	是否为最后一页

`jsm_create_request`

在 Jira Service Management 中创建新的服务请求

输入

参数	类型	必填	说明
`domain`	string	是	你的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要创建请求的服务台 ID
`requestTypeId`	string	是	新请求的请求类型 ID
`summary`	string	是	服务请求的摘要/标题
`description`	string	否	服务请求的描述
`raiseOnBehalfOf`	string	否	代表客户提交请求的账户 ID

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueId`	string	创建的请求问题 ID
`issueKey`	string	创建的请求问题键（例如 SD-123）
`requestTypeId`	string	请求类型 ID
`serviceDeskId`	string	服务台 ID
`success`	boolean	请求是否创建成功
`url`	string	创建的请求的 URL

`jsm_get_request`

从 Jira Service Management 获取单个服务请求

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net ）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键（例如 SD-123 ）

输出

参数	类型	说明
`ts`	string	操作的时间戳

`jsm_get_requests`

从 Jira Service Management 获取多个服务请求

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net ）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	否	按服务台 ID 过滤
`requestOwnership`	string	否	按所有权过滤： OWNED_REQUESTS 、 PARTICIPATED_REQUESTS 、 ORGANIZATION 、 ALL_REQUESTS
`requestStatus`	string	否	按状态过滤： OPEN 、 CLOSED 、 ALL
`searchTerm`	string	否	用于筛选请求的搜索词
`start`	number	否	分页起始索引（默认值： 0 ）
`limit`	number	否	返回的最大结果数（默认值： 50 ）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`requests`	json	服务请求数组
`total`	number	请求总数
`isLastPage`	boolean	是否为最后一页

`jsm_add_comment`

在 Jira Service Management 中为服务请求添加评论（公开或内部）

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或关键字（例如 SD-123）
`body`	string	是	评论正文内容
`isPublic`	boolean	是	评论是公开（对客户可见）还是内部

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或关键字
`commentId`	string	创建的评论 ID
`body`	string	评论正文内容
`isPublic`	boolean	评论是否为公开
`success`	boolean	评论是否添加成功

`jsm_get_comments`

获取 Jira Service Management 中服务请求的评论

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或关键字（例如 SD-123）
`isPublic`	boolean	否	仅筛选公开评论
`internal`	boolean	否	仅筛选内部评论
`start`	number	否	分页起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`comments`	json	评论数组
`total`	number	评论总数
`isLastPage`	boolean	是否为最后一页

`jsm_get_customers`

获取 Jira Service Management 服务台的客户

输入

参数	类型	是否必填	说明
`domain`	string	是	你的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要获取客户的服务台 ID
`query`	string	否	用于筛选客户的搜索查询
`start`	number	否	分页的起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`customers`	json	客户数组
`total`	number	客户总数
`isLastPage`	boolean	是否为最后一页

`jsm_add_customer`

向 Jira Service Management 服务台添加客户

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要添加客户的服务台 ID
`emails`	string	是	以逗号分隔的要添加为客户的邮箱地址

输出

参数	类型	说明
`ts`	string	操作的时间戳
`serviceDeskId`	string	服务台 ID
`success`	boolean	是否成功添加了客户

`jsm_get_organizations`

获取 Jira Service Management 服务台的组织

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要获取组织的服务台 ID
`start`	number	否	分页起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`organizations`	json	组织数组
`total`	number	组织总数
`isLastPage`	boolean	是否为最后一页

`jsm_create_organization`

在 Jira Service Management 中创建一个新组织

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`name`	string	是	要创建的组织名称

输出

参数	类型	说明
`ts`	string	操作的时间戳
`organizationId`	string	已创建组织的 ID
`name`	string	已创建组织的名称
`success`	boolean	操作是否成功

`jsm_add_organization`

在 Jira Service Management 中将组织添加到服务台

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要添加组织的服务台 ID
`organizationId`	string	是	要添加到服务台的组织 ID

输出

参数	类型	说明
`ts`	string	操作的时间戳
`serviceDeskId`	string	服务台 ID
`organizationId`	string	已添加的组织 ID
`success`	boolean	操作是否成功

`jsm_get_queues`

获取 Jira Service Management 中服务台的队列

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	要获取队列的服务台 ID
`includeCount`	boolean	否	是否包含每个队列的问题数量
`start`	number	否	分页的起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`queues`	json	队列数组
`total`	number	队列总数
`isLastPage`	boolean	是否为最后一页

`jsm_get_sla`

获取 Jira Service Management 中服务请求的 SLA 信息

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或关键字（例如：SD-123）
`start`	number	否	分页的起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`slas`	json	SLA 信息数组
`total`	number	SLA 总数
`isLastPage`	boolean	是否为最后一页

`jsm_get_transitions`

获取 Jira Service Management 中服务请求的可用流转

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键值（例如：SD-123）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`transitions`	json	可用流转的数组

`jsm_transition_request`

将服务请求流转到 Jira Service Management 中的新状态

输入

参数	类型	必填	说明
`domain`	string	是	您的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键值（例如：SD-123）
`transitionId`	string	是	要应用的流转 ID
`comment`	string	否	流转时可选的备注

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`transitionId`	string	已应用的转换 ID
`success`	boolean	转换是否成功

`jsm_get_participants`

获取 Jira Service Management 请求的参与者

输入

参数	类型	是否必填	说明
`domain`	string	是	你的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键值（例如 SD-123）
`start`	number	否	分页起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`participants`	json	参与者数组
`total`	number	参与者总数
`isLastPage`	boolean	是否为最后一页

`jsm_add_participants`

为 Jira Service Management 请求添加参与者

输入

参数	类型	是否必填	说明
`domain`	string	是	你的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键值（例如 SD-123）
`accountIds`	string	是	以逗号分隔的要添加为参与者的账户 ID

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`participants`	json	新增参与者数组
`success`	boolean	操作是否成功

`jsm_get_approvals`

在 Jira Service Management 中获取请求的审批信息

输入

参数	类型	是否必填	说明
`domain`	string	是	你的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键值（例如 SD-123）
`start`	number	否	分页起始索引（默认值：0）
`limit`	number	否	返回的最大结果数（默认值：50）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键值
`approvals`	json	审批数组
`total`	number	审批总数
`isLastPage`	boolean	是否为最后一页

`jsm_answer_approval`

在 Jira Service Management 中批准或拒绝审批请求

输入

参数	类型	是否必填	说明
`domain`	string	是	你的 Jira 域名（例如 yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键值（例如 SD-123）
`approvalId`	string	是	需要答复的审批 ID
`decision`	string	是	决策：“approve” 或 “decline”

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或 key
`approvalId`	string	审批 ID
`decision`	string	做出的决定（approve/decline）
`success`	boolean	操作是否成功

备注

分类：tools
类型：jira_service_management

参数	类型	必填	说明
`domain`	string	是	你的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`issueIdOrKey`	string	是	问题 ID 或键（例如：SD-123）
`approvalId`	string	是	要答复的审批 ID
`decision`	string	是	决策："approve" 或 "decline"

输出

参数	类型	说明
`ts`	string	操作的时间戳
`issueIdOrKey`	string	问题 ID 或键
`approvalId`	string	审批 ID
`decision`	string	做出的决策（approve/decline）
`id`	string	响应中的审批 ID
`name`	string	审批描述
`finalDecision`	string	最终审批决策：pending、approved 或 declined
`canAnswerApproval`	boolean	当前用户是否还能答复
`approvers`	array	更新后的审批人及其决策列表
↳ `approver`	object	审批人用户详情
↳ `accountId`	string	审批人账号 ID
↳ `displayName`	string	审批人显示名
↳ `emailAddress`	string	审批人邮箱
↳ `active`	boolean	账号是否激活
↳ `approverDecision`	string	单个审批人的决策
`createdDate`	json	审批创建日期
`completedDate`	json	审批完成日期
`approval`	json	审批对象
`success`	boolean	操作是否成功

`jsm_get_request_type_fields`

获取在 Jira Service Management 中创建特定类型请求所需的字段

输入

参数	类型	必填	说明
`domain`	string	是	你的 Jira 域名（例如：yourcompany.atlassian.net）
`cloudId`	string	否	实例的 Jira Cloud ID
`serviceDeskId`	string	是	服务台 ID（例如：“1”、“2”）
`requestTypeId`	string	是	请求类型 ID（例如：“10”、“15”）

输出

参数	类型	说明
`ts`	string	操作的时间戳
`serviceDeskId`	string	服务台 ID
`requestTypeId`	string	请求类型 ID
`canAddRequestParticipants`	boolean	是否可以为此类型的请求添加参与者
`canRaiseOnBehalfOf`	boolean	是否可以代表其他用户提交请求
`requestTypeFields`	array	此请求类型的字段列表
↳ `fieldId`	string	字段标识符（如 summary、description、customfield_10010）
↳ `name`	string	字段可读名称
↳ `description`	string	字段帮助文本
↳ `required`	boolean	字段是否为必填项
↳ `visible`	boolean	字段是否可见
↳ `validValues`	json	下拉选择字段的允许值
↳ `presetValues`	json	预填充值
↳ `defaultValues`	json	字段默认值
↳ `jiraSchema`	json	Jira 字段 schema，包括类型、系统、自定义、自定义 ID

Jira Service Management

On this page