文档 API参考

参考条件

“支持REST API”中的亚博电脑端以下资源使用条件属性:

的SLA策略有一个过滤器属性，它与条件财产。

的条件属性由一个对象组成，该对象包含在执行操作之前要检查的条件。对象定义了两个名为所有和任何一个或多个条件的

例子

             

              
｛“条件”:｛“所有”:(｛“字段”:“状态”，“运营商”:“less_than”，“价值”:“解决”｝，｛“字段”:“assignee_id”，“运营商”:“是”，“价值”:“296220096”｝］，“任何”:(］｝｝

第一个数组列出了所有必须满足的条件。第二个数组列出了必须满足的任何条件。

的名字 类型 描述
所有 数组 逻辑。所有的条件都必须满足
任何 数组 逻辑或。任何条件都可以满足

数组中的每个条件都有以下属性:

的名字 类型 描述
场 字符串 票据字段的名称
操作符 字符串 比较运算符
价值 字符串 ticket字段的值

例子

             

              
｛“字段”:“状态”，“运营商”:“less_than”，“价值”:“解决”｝

在PUT或POST请求中指定条件时，使用所有和任何数组没有条件财产。例子:

             

              
｛“所有”:(｛“字段”:“状态”，“运营商”:“less_than”，“价值”:“解决”｝，｛“字段”:“assignee_id”，“运营商”:“是”，“价值”:“296220096”｝］，“任何”:(｛“字段”:“current_tags”，“运营商”:“包括”，“价值”:“你好”｝］，…｝

共享的条件

以下条件由触发器、自动化、视图和SLA策略共享。

场 操作符 价值
group_id “是”、“is_not” ""(没有分配给票据的组)或分配给票据的组的数字id
assignee_id “是”、“is_not” ""(没有人分配给票据)，"current_user"，或者分配给票据的代理的数字id
requester_id “是”、“is_not” ""(没有指定请求者)，"current_user"，或者请求者或受让人的数字id
organization_id “是”、“is_not” ""(没有添加到票据中的组织)或添加到票据中的组织的数字id
current_tags “包括”、“not_includes” 以空格分隔的标签列表，用于与门票的标签进行比较
via_id “是”、“is_not” 用于创建票据的通道的数字id。看到通过类型
收件人 省略了操作符财产 对于视图和自动化，是接收票据的电子邮件地址中的帐户名。对于触发器和SLA策略，完整的电子邮件地址，其中可以包括外部地址
custom_fields_ {id} “是”、“is_not” 指定自定义票据字段的id。看到票字段．可能的值因字段而异。看到设置自定义字段值

触发器、自动化和视图的附加条件

除了共享条件之外，触发器、自动化和视图还共享以下条件。

场 操作符 价值
类型 “是”、“is_not” "question"， "incident"， "problem"或"task"
状态 is, is_not, less_than, greater_than “新”、“开放”、“等待”、“持有”,“解决”或“关闭”
优先级 is, is_not, less_than, greater_than ""(没有优先级分配给机票)，"低"，"正常"，"高"，或"紧急"
description_includes_word "includes"(包含一个单词)，"not_includes"(不包含任何单词)，"is"(包含字符串)，"is_not"(不包含字符串) 票据主题中的单个单词或字符串。在触发器中不可用
locale_id “是”、“is_not” 提交票证的人所在地区的数字id。看到列表区域列出该帐户的可用区域设置id
satisfaction_score is, is_not, less_than, greater_than "good_with_comment"， "good"， "bad_with_comment"， "bad"， false(提供)，或true(非官方)

触发器和自动化的附加条件

除了共享条件外，触发器和自动化还共享以下条件。

场 操作符 价值
user.custom_fields_{关键} "is"， "is_not"， "present"(省略值)，"not_present"(省略值)，"includes"(包含一个单词)，"not_includes"(不包含任何单词)，" incles_string "(包含字符串)，" not_incles_string "(不包含字符串) 指定自定义用户字段的键。看到用户字段．可能的值因字段而异。看到user_fields在用户API中
organization.custom_fields_{关键} "is"， "is_not"， "present"(省略值)，"not_present"(省略值)，"includes"(包含一个单词)，"not_includes"(不包含任何单词)，" incles_string "(包含字符串)，" not_incles_string "(不包含字符串) 指定自定义组织字段的键。看到组织领域．可能的值因字段而异。看到organization_fields在组织API中

触发器的附加操作符和条件

对于某些共享字段，触发器具有以下附加操作符。

字段 其他触发操作符
状态，类型，优先级，group_id, assignnee_id, requester_id, organization_id, satisfaction_score "changed"(省略value属性)，"value"(更改为)，"value_previous"(更改为)，"not_changed"， "not_value"(未更改为)，"not_value_previous"(未更改为)

除了共享条件外，触发器还具有以下附加条件。

场 操作符 价值
subject_includes_word "includes"(包含一个单词)，"not_includes"(不包含任何单词)，"is"(包含字符串)，"is_not"(不包含字符串) 主题中的单个单词或字符串
comment_includes_word "includes"(包含一个单词)，"not_includes"(不包含任何单词)，"is"(包含字符串)，"is_not"(不包含字符串) 评论主体或正文中的单个单词或字符串
current_via_id “是”、“is_not” 用于更新票据的通道的数字id。看到通过类型表格
update_type 省略了操作符财产 “创造”或“改变”
comment_is_public 省略了操作符财产 True, false， "not_relevant"(当前)，或"requester_can_see_comment"(当前且请求者可以看到注释)
ticket_is_public 省略了操作符财产 “公共”、“私人”
重开 "less_than"， "greater_than"， "is" 票据从已解决转到未处理或待处理的次数
回复 "less_than"， "greater_than"， "is" 公共代理注释的数量。
agent_stations "less_than"， "greater_than"， "is" 将票据分配给的不同代理的数目
group_stations "less_than"， "greater_than"， "is" 分配给一个票的不同组的数目
in_business_hours 省略了操作符财产 对或错。仅当管理员启用营业时间时可用
requester_twitter_followers_count "less_than"， "greater_than"， "is" 请求者的Twitter追随者的数量
requester_twitter_statuses_count "less_than"， "greater_than"， "is" 请求者的推文总数
requester_twitter_verified 省略了操作符财产 省略value属性。如果请求者有一个经过验证的Twitter帐户，则条件为真
requester_role “是”、“is_not” 票据请求者的角色。角色类型包括agent、admin和终端用户。如果你正在使用光代理，光代理角色类型是可用的
附件 省略了操作符财产 如果票据有附件，则条件为真。除了使用宏添加到票据的内联附件外，附加附件和内联附件都包括在内
cc 省略了操作符财产 如果票上有合作者抄送，条件为真。它不检查关注者或@提及
custom_status_id "includes"(包含一个或多个id)， "not_includes"(不包含id)， "is"， "is_not"， "changed"(省略值属性)，"value"(更改为)，"value_previous"(更改为)，"not_changed"， "not_value"(未更改为)，"not_value_previous"(未更改为) 自定义票据状态id

其他SLA策略条件

除了共享条件外，SLA策略还具有以下附加条件。

场 操作符 价值
ticket_type_id “是”、“is_not” 票据类型的数字id: 1(问题)、2(事件)、3(问题)或4(任务)
current_via_id “是”、“is_not” 用于更新票据的通道的数字id。看到通过类型
exact_created_at "less_than"， "less_than_equal"， "greater_than"， "greater_than_equal" 创建票据的时间
custom_status_id “是”、“is_not” 自定义票据状态id

自动化和视图的其他基于时间的条件

自动化和视图具有以下基于时间的条件。基于时间的条件只能在所有数组，而不是任何数组。

场 价值
新 从创建票据到现在的几个小时
开放 离开票已经几个小时了
等待 几小时前机票被改成待定了
解决了 几小时前罚单就被改成破案了
关闭 票已经停了好几个小时了
assigned_at 工作时间
updated_at 更新后的时间
requester_updated_at 请求者更新后数小时
assignee_updated_at 自受让人更新后的小时数
due_date 截止日期数小时后。对于类型设置为任务的票据
until_due_date 离预产期还有几个小时。对于类型设置为任务的票据

基于时间的条件都共享相同的操作符值:

操作符
“是”
“is_business_hours”
“less_than”
“less_than_business_hours”
“greater_than”
“greater_than_business_hours”

视图的附加条件

除了共享条件外，视图还具有以下条件。

场 操作符 价值
custom_status_id "includes"(包含一个或多个id)， "not_includes"(不包含任何id) 自定义票据状态id

自动化的附加条件

除了共享条件外，自动化还具有以下条件。

场 操作符 价值
custom_status_id “是”、“is_not” 自定义票据状态id