请求管理API字段详细信息表

请求管理API字段详细信息表

属性名

类型

details

描述

id

long(Read Only)

Id of this request

请求在数据库中存储的唯一标识

subject

String

Subject of this request

主题

description

HTML Desc

Description of this request

描述

short_description

String

A short description of this request

短描述

request_type

Object

Type of this request

请求类型

impact

Object

Impact of this request

影响

impact_details

String

Description about the impact of this request

影响明细

status

Object

Indicates the current status of this request

状态

mode

Object

The mode in which this request is created.

模式

Level

Object

Level of the request

级别

urgency

Object

Urgency of the request

紧急度

priority

Object

Priority of the request

优先级

service_category

Object

Service category to which this request belongs

服务类别

requester

Object

Indicates the requester of this request

请求人

department

Object(Read Only)

Department to which this requester belongs

请求人所属部门

assets

Array of Objects

Array of asset objects associated to this request.

与此请求关联的资产对象数组

deleted_assets

Array of Objects

Array of deleted asset names associated to this request.

与此请求关联的已删除资产名称数组

deleted_on

Object

Indicates the time at which this request is deleted

删除此请求的时间

deleted_by

Object

Indicates the user who deleted the request

删除此请求的用户

site

Object

Denotes the site to which this request belongs

此请求所属的站点

group

Object

Group to which this request belongs

此请求所属的组

technician

Object

Technician assigned to this request

此请求所属的技术员

category

Object

Category to which this request belongs

分类

subcategory

Object

Subcategory to which this request belongs

子分类

item

Object

Item of this request

条目

on_behalf_of

Object

Requests created on behalf of an another user

代表另一个用户创建的请求

service_approvers

Array of Objects

Array of user objects containing the approver(s) for this request

此请求批准者的对象数组

sla

Object(Read Only)

SLA details associated with this request

服务级别协议

service_cost

double(Read Only)

Cost involved in the service other than resources.

除资源外,服务所涉及的成本。

total_cost

double(Read Only)

Service cost plus the selected resource cost.

总成本

template

Object

Indicates the template which is used to create this request

创建此请求的模板

request_template_task_ids

Array of Objects

Array of template tasks id objects which are associated to this request

请求关联的模板任务 id 对象数组

created_by

Object(Read Only)

Indicates the requester who created this request

请求人

editor

Object

User having intermediate editing role for this request

对此请求有编辑角色的用户

email_ids_to_notify

Array of Objects

Array of Email ids, which needs to be notified about the happenings of this request

需要通知此请求的发生情况的邮件数组

email_to

Array(Read Only)

List of email addresses(to addresses) which received the request through e-mail

接收请求的邮件地址列表

email_cc

Array(Read Only)

List of e-mail addresses(cc addresses) which received the request through e-mail.

接收请求的抄送邮件地址列表

update_reason

String

The reason for updating this request

更新请求的原因

status_change_comments

String

Comments added while changing the request's status

更改请求状态时添加的评论

time_elapsed

long(Read Only)

Indicates the time spent on this request

该请求上花费的时间

approval_status

String(Read Only)

Denotes the approval status of this request.(Approved/Pending Approval/Rejected)

该请求的批准状态

notification_status

String(Read Only)

Shows the current status of request's replies, whether last one from requester or technician.

请求的回复状态

linked_requests_count

Number(Read Only)

Count of requests linked to this request

被链接的请求总数

created_time

Date Object

Indicates the time at which this request is created

创建时间

due_by_time

Date Object

Indicates the time at which this request is scheduled to be completed

计划逾期时间

first_response_due_by_time

Date Object

Indicates the time at which the first response for this request is scheduled

首次响应逾期时间

completed_time

Date Object(Read Only)

Indicates the time at which this request is completed

完成时间

resolved_time

Date Object(Read Only)

Indicates the time at which this request is resolved

解决的日期

responded_time

Date Object(Read Only)

Indicates the time at which this request is responded

回复时间

assigned_time

Date Object(Read Only)

Indicates the time at which this request is assigned to a technician

分配时间

last_updated_time

Date Object(Read Only)

Indicates the time when this request is last updated

最后更新时间

has_request_initiated_change

Boolean(Read Only)

Boolean value indicating whether this request is associated to a change or not

是否有关联的更改

has_request_caused_by_change

Boolean(Read Only)

Boolean value indicating whether this request is caused by a change or not

是否有因此请求导致的变更

has_project

Boolean(Read Only)

Boolean value indicating whether this request is associated to a project or not

是否有关联的项目

has_problem

Boolean(Read Only)

Boolean value indicating whether this request is associated to a problem or not

是否有关联的问题

has_purchase_orders

Boolean(Read Only)

Boolean value indicating whether this request is associated to Purchase Order(s)

是否有关联的购买请求

has_draft

Boolean(Read Only)

Boolean value indicating whether this request has drafts or not

是否有关联的草稿

is_reopened

Boolean(Read Only)

Boolean value indicating whether this request is reopened or not

是否有回复

has_dependency

Boolean(Read Only)

Boolean value indicating whether this request has a dependency or not

是否有依赖性

is_fcr

Boolean

Boolean value indicating if the request has been marked as First Call Resolution

是否首次呼叫解决

has_linked_requests

Boolean(Read Only)

Boolean value indicating whether this request has any linked requests or not

是否有关联的请求

has_attachments

Boolean(Read Only)

Boolean value indicating whether this request has any attachments or not

是否有附件

has_notes

Boolean(Read Only)

Boolean value indicating whether this request has any notes or not

是否有注释

is_trashed

Boolean(Read Only)

Boolean value indicating whether this request is in trash

是否在回收站

is_service_request

Boolean(Read Only)

Boolean value indicating whether this request is a service request or not

是否是服务请求

is_overdue

Boolean(Read Only)

Boolean value indicating whether this request is overdue

是否超时

is_read

Boolean(Read Only)

Boolean value indicating whether this request's replies are read or not

是否已读

is_first_response_overdue

Boolean(Read Only)

Boolean value indicating whether this request is in overdue to make first response

首次响应逾期状态

has_my_worklog_timer

Boolean(Read Only)

Boolean value indicating if the request has a worklog timer for the logged user

是否有工作日志

is_editing_completed

Boolean(Read Only)

Boolean value indicating if the configured editor has already completed his editing.

配置的编辑器是否已经完成编辑

attachments

Array of Objects

Attached file list to this request

附件

resources

Object

Holds the resource data mapped to the request. Data sample :- "resources":{"res_301":{"qstn_simple_309":{"name":"Yes", "cost":"100.00"},"qstn_select_310":{"id":"305","name":"Microsoft Office Enterprise 2007","cost":"350.00"},"qstn_check_307":[{"id":"301","name":"access point 1"},{"id":"302","name":"access point 2"}],"qstn_select_2":{"name":"Mac OSX"},"qstn_text_308":{"value":"MacBook Air"},"qstn_text_312":null,"qstn_simple_301":null,"qstn_check_6":[],"qstn_select_302":null}}

资源

udf_fields

Object

Holds udf fields' values associated with the request. Data sample :- "udf_fields":{"udf_date_601":{"display_value":"Mar 9, 2017 04:36 PM","value":"1489057560000"},"udf_pick_20":"Admin","udf_mline_314":"USA","udf_pick_44":"Heather Graham","udf_long_367":"123654789","udf_sline_25":"5 th floor","udf_sline_26":"6th floor","udf_decimal_42":"124.00"}

用户自定义字段

resolution

Object

Resolution given for the request will be captured.

解决方案

content

String

Resolution content provided by the technician to resolve this request.

解决方法

submitted_on

Date Object(Read Only)

Denotes the submitted time of the resolution

解决方案提交的时间和解决方案id

submitted_by

Object(Read Only)

Denotes the technician who provided the resolution.

解决方案的提交人

add_to_linked_requests

Boolean

Boolean value indicating whether to add resolution content to the linked requests

是否向链接请求添加解析内容

closure_info

Object

Information like closure_code, comments while closing request is captured under this subsection

关闭信息

closure_code

Object

Denotes the closure code info of the Request

关闭代码

requester_ack_resolution

Boolean

Denotes if the requester has acknowledged the resolution he/she has been given.

请求者是否已确认给出的解决方案

requester_ack_comments

String

Comments from the requester in regards to the resolution he/she has been given

请求者对解决发难的评论

closure_comments

String

Comments for closing the request

关闭请求的注释

onhold_scheduler

Object

Onhold scheduler details

中止详情

scheduled_time

Date Object

Denotes the scheduled time for the onhold scheduler to change the Request's status

中止时间

comments

String

Comments for the onhold schedule

中止注释

holded_by

Object(Read Only)

User object of the user who put the request onhold

中止人

change_to_status

Object

Status object to which the request is scheduled to move to, after the onhold scheduler is completed.

中止动作后的状态

linked_to_request

Object

Contains linked to request details

链接请求详情

request

Object

Request object containing minimal request data

被链接的请求

comments

String

Comments added for linking requests

链接请求的备注


用户自定义字段

用户新建一个附件字段后,SDP会自动生成对应的API字段名称,如图:


请求的JSON字符串示例

{
    "request":{
        "ola_due_by_time":null,
        "subject":"网络问题:",
        "resolution":{
            "submitted_on":{
                "display_value":"12/07/2021 10:34 AM",
                "value":"1626057258711"
            }
,
            "submitted_by":{
                "email_id":null,
                "phone":null,
                "name":"System",
                "mobile":null,
                "is_vipuser":false,
                "id":"1",
                "department":null
            }
,
            "resolution_attachments":[

            ]
,
            "content":"标题 : 网络无法连接。<br />描述 : <div>可以到  张斌处申请一个 免驱的无线网卡,暂时先连接公司的wifi进行工作。<br /></div><br /><br /><br /><br />问题 变通方法 :按之前提供的连接方法讲已连接打印机删除后再添加<div><br /></div><br /><br />问题 解决方案 :  <div>测试复制到所有关联请求</div>"
        }
,
        "linked_to_request":null,
        "onhold_time":null,
        "mode":{
            "name":"Web Form",
            "id":"2"
        }
,
        "is_read":true,
        "lifecycle":null,
        "reason_for_cancel":null,
        "is_trashed":false,
        "id":"34",
        "assigned_time":{
            "display_value":"08/07/2021 10:49 AM",
            "value":"1625712546841"
        }
,
        "group":null,
        "requester":{
            "email_id":"test1@test.com",
            "phone":"8888",
            "name":"Guest",
            "mobile":"1234567890",
            "is_vipuser":false,
            "id":"3",
            "department":null
        }
,
        "cancel_requested_by":null,
        "email_to":[

        ]
,
        "sla_violated_technician":null,
        "created_time":{
            "display_value":"08/07/2021 10:45 AM",
            "value":"1625712345375"
        }
,
        "item":null,
        "level":{
            "name":"Tier 2",
            "id":"2"
        }
,
        "has_resolution_attachments":false,
        "approval_status":{
            "name":"Pending Approval",
            "id":"1"
        }
,
        "service_category":null,
        "sla":{
            "name":"High SLA",
            "id":"4"
        }
,
        "priority":{
            "color":"#ff0000",
            "name":"High",
            "id":"4"
        }
,
        "created_by":{
            "email_id":"test1@test.com",
            "phone":"8888",
            "name":"Guest",
            "mobile":"1234567890",
            "is_vipuser":false,
            "id":"3",
            "department":null
        }
,
        "sla_violated_group":null,
        "scheduled_end_time":null,
        "tags":[

        ]
,
        "first_response_due_by_time":null,
        "last_updated_time":{
            "display_value":"16/07/2021 10:57 AM",
            "value":"1626404254458"
        }
,
        "has_notes":false,
        "udf_fields":{
            "udf_pick_901":"× 叉号  放置上去提示无网络连接",
            "udf_pick_904":null,
            "udf_pick_906":null,
            "udf_pick_907":"windows系统"
        }
,
        "subcategory":null,
        "email_cc":[

        ]
,
        "status":{
            "color":"#00ffcc",
            "name":"处理中",
            "id":"6"
        }
,
        "scheduled_start_time":null,
        "template":{
            "is_service_template":false,
            "name":"网络问题",
            "id":"1201"
        }
,
        "email_ids_to_notify":[

        ]
,
        "request_type":null,
        "cancel_requested_time":null,
        "notification_status":null,
        "description":null,
        "has_dependency":false,
        "has_conversation":false,
        "callback_url":null,
        "chat_type":0,
        "is_service_request":false,
        "is_shared":false,
        "cancel_requested":false,
        "request_template_task_ids":[

        ]
,
        "department":null,
        "is_reopened":false,
        "has_draft":false,
        "has_attachments":false,
        "has_linked_requests":false,
        "is_overdue":true,
        "technician":{
            "email_id":"test2@test.com",
            "phone":"1234455",
            "name":"Administrator",
            "mobile":"1234567890",
            "is_vipuser":false,
            "id":"4",
            "department":{
                "site":null,
                "name":"IT部门",
                "id":601
            }

        }
,
        "due_by_time":{
            "display_value":"08/07/2021 11:45 AM",
            "value":"1625715945375"
        }
,
        "site":null,
        "is_first_response_overdue":false,
        "cancel_requested_is_pending":false,
        "recommend_template":null,
        "unreplied_count":null,
        "category":{
            "name":"打印机问题",
            "id":"6"
        }

    }
,
    "response_status":{
        "status_code":2000,
        "status":"success"
    }

}

    • Related Articles

    • 如何合并请求?

      ServiceDesk Plus 可以支持您合并2个或多个请求工单,将其归纳到一个请求下。您可以在请求列表页面或者请求明细页面执行请求合并。 您可以从过以下两个示例来了解请求合并的过程,以及那个请求将作为“父请求”,即显示给技术员的请求。 打开请求列表页面,现在我将要合并2个请求,请求ID:10和7。所以我选择了这些请求前的复选框,点击点击了动作下拉菜单里的合并选项。那么哪个请求是父请求呢? 7 10 或是其它 答案是 -> 7 ...
    • [工单][表单字段规则] 如何应用表单字段规则在工单中获取请求人附加字段值

      此功能用于获取保存在“用户-附加字段”中的请求人的附加信息,并将该字段的值赋给工单模板中的某个字段。可以在故障单或服务单模板的表单字段规则中使用附件中的脚本来达到这个效果。适用于ServiceDesk 10及以前版本; 通过工单选中的请求人的显示名和Email地址来发起一个CMDB的API调用。用户的附加字段的名称及UDF名称作为输入在java脚本提供。 使用实例 某些员工详细信息是从Active ...
    • 我怎么禁用“关闭请求”的弹出窗口?

      根据ITIL,仅当用户确认了帮助台提供的解决方法可以用于解决问题时,事件才能关闭。这是也是为什么我们会设计系统会在关闭事件时弹出提示窗口的主要因素,这是ITIL里的一项最佳实践。但是您也可以根据您的使用系统,选择禁用此功能。 点击管理-> 事件管理 -> 请求关闭规则 ->用户认知确认部分设置。
    • SDP SaaS API学习汇总

      DataCenter API Domain URL Accounts Server URL API Endpoint China https://servicedeskplus.cn https://accounts.zoho.com.cn https://servicedeskplus.cn/api/v3/requests 授权领牌/认证代码 - 认证服务器创建的临时领牌,用于客户端认证 访问领牌,执行API操作,时限1小时 刷新领牌,重新获取访问领牌 ...
    • 我的机构里其它部门采用了不同的服务台解决方案,我想让在那个服务台里创建的工单,同时也创建到ServiceDesk Plus,可以吗?

      是的,您可以使用我们的API功能(管理 -> 常规 -> API)。在ServiceDesk Plus中创建一个与其它应用一致的表单来采集数据,通过调用API,在ServiceDesk Plus中创建工单。 您也可以从其它服务台上导出请求为XLS格式,然后在ServiceDesk Plus的请求部分,导入这些请求。