创建预先填写的票务表格

Nova黎明

编辑2023年4月11日20:27

亚博Zendesk文档团队

我的计划是什么?

套件成长，专业，企业和企业Plus 专业企业计划

您可以在特定字段(例如Subject或Description字段)中设置预先填充值的票据表单。这可以为您的最终用户节省时间，并使他们更接近解决方案。它也有利于您的支持代理，确保他们从客户那里得到准确和具体的输入。

例如，如果您的帮助中心中有一篇文章解释了如何对咖啡机进行故障排除，那么您可以在文章末尾创建一个链接，该链接打开一个预先填充了咖啡机模型和问题的票据表单。点击此链接的用户在提交票证时需要填写的信息要少得多。

您必须是管理员才能创建预填写的票务表单。

注意:此功能要求您的主题使用template API版本2。要查看您的版本，请参见关于Guide模板版本。

预填票表格(2:03)

本文包括以下部分:

配置预填写的票务表单

当您创建预填写的票据表单时，您可以将希望预填写的字段的参数添加到表单的URL中。如果您有多个票证表单，您还将在URL中包含特定的票证表单ID。

在表单中配置预填充的字段

复制最终用户在点击时看到的票务表单的URL提交请求并将其粘贴到文本编辑器文件中。
它应该像这样，其中mycompany是你的子域名吗?https://mycompany.亚博zendesk.com/hc/en-us/requests/new?
注意:如果您有主机映射，那么您的URL看起来将与前面的示例不同(参见主机映射-更改帮助中心的URL）.
(只适用于多张购票表格)在管理中心,点击对象和规则在侧边栏中，然后选择门票>表格。选择您想要预填写的票据表单，然后从支持中的URL复制表单ID，并将ID粘贴到文本编辑器中URL的末尾。
在管理中心,点击对象和规则在侧边栏中，然后选择门票>字段。复制要预填充的字段值，并将它们与值一起粘贴到文本编辑器中URL的末尾。
为系统值，复制字段的标题(例如“Subject”)。使用以下格式将标题粘贴到您正在构建的URL的末尾，以及要分配给该字段的值:
&tf_{标题}= {value}
为自定义值时，复制该字段的字段ID(例如“12345”)。使用以下格式将字段ID粘贴到您正在构建的URL的末尾，以及要分配给该字段的值:
&tf_ [fieldID} = {value}
根据需要继续在文本编辑器的URL末尾添加字段和值。
参数应类似如下示例:
&tf_subject=充电器故障999召回&tf_12345=USA
从文本编辑器复制URL并将其粘贴到您希望将最终用户链接到预填写表单的任何位置。
您的最终URL应该类似于以下示例之一:
单票形式:
https://www.example.亚博zendesk.com/hc/en-us/requests/new?tf_subject=Faulty充电器999召回&tf_12345=USA
多票形式:
https://www.example.亚博zendesk.com/hc/en-us/requests/new?ticket_form_id=1500000300222&tf_subject=Faulty充电器999召回&tf_12345=USA

参数键和值

URL参数键和值根据要预填充的字段类型而有所不同。在请求票证表单中有两种不同的字段类型:

系统字段-是票证中的默认字段，并且具有唯一的名称。
自定义字段-是您可以创建的字段，以补充已经从现有系统字段中收集的信息。

系统字段

系统字段的URL参数使用前缀tf_后面跟着字段名。例如tf_subject。有关更多信息，请参见系统票证字段。Zendesk系统字段使用以下参数:亚博

电子邮件：tf_anonymous_requester_email
优先级:包括值类型(low、norm、high、urgent)，例如在字段名之后tf_priority =高
类型:包括字段名后的值类型，例如tf_type =事件
描述：tf_description
主题：tf_subject
到期日期:(当Type=task时使用)使用标准日期格式“YYY-MM-DD”tf_due_at
Cc:(用户登录时使用)。例如，用逗号分隔邮件，而不是空格tf_collaborators = name1@example.com, name2@example.com
组织ID:包括字段名后的值类型，例如tf_organization_id = 123456789

自定义字段

自定义字段的URL参数使用前缀tf_后面跟着字段ID。例如tf_40630945。有关更多信息，请参见关于自定义字段类型。使用自定义对象，您可以创建以下自定义字段:

同时选中:使用字段标记作为值，并用逗号分隔，而不是空格，例如blue,green,red。
下拉菜单:使用与该值相关联的标签。例如tf_40630945 = dog_beagle。
复选框:使用true/false值
小数:使用整数和非整数(例如-8.012345679)。不要使用逗号。
日期:使用标准日期格式:YYYY-MM-DD

回到顶端

93条评论

西蒙
- 2021年4月20日08:32
社区的主持人
嘿,团队,

这是一个非常整洁的功能，也是我在以前的项目中需要的东西-所以这个项目做得很好!

然而，我只能让它在一个干净的哥本哈根主题安装上工作，而不是在例如，我目前正在工作的重度自定义主题，这实际上也是基于哥本哈根主题。我不知道是否我的其他javascript导致这个，因为我没有得到任何控制台错误或类似的?

如果你想要一些会话检查，请随时联系我们:-)

1
Kasper Sørensen
- 2021年4月20日10:28
亚博Zendesk产品经理
嗨@……

谢谢你提出这个问题。这个新特性只有在您的主题使用template API v2时才可用。您的自定义主题可能使用模板API v1?

0
西蒙
- 2021年4月20日11:02
社区的主持人
嘿@……

感谢您的快速回复!

我可以确认我的主题是建立在API v2上的-但是为了更好的衡量，这可能应该添加到这篇文章中作为提醒:-)

0
Kasper Sørensen
- 2021年4月20日11:09
亚博Zendesk产品经理
正在努力中:)

0
Nova黎明
- 2021年4月20日15:28
亚博Zendesk文档团队
谢谢你提出这个问题西蒙Blouner，这是对文档的一个很好的补充。

0
马特Heroux
- 2021年4月21日16:43
我们可以通过文本字段或数字值?或者只是上面列出的字段类型?

0
Kasper Sørensen
- 2021年4月22日08:47
亚博Zendesk产品经理
@……绝对的!我认为本文只是想为格式重要的字段类型指定所需的格式。对于文本和数字，你只需要传递文本或数字:-)就像:
```
/ hc / en - us /请求/新吗?tf_1234 =你好
```
0
布鲁斯解决
- 2021年5月5日14:10
嗨,团队,

我喜欢这个功能!问题:这是否也适用于条件字段，当窗体打开时还不可见?

谢谢!

布鲁斯

2
Kasper Sørensen
- 2021年5月5日14:52
亚博Zendesk产品经理
嗨@……，

是的，它也适用于条件字段，即使它们最初没有显示。

1
雅子K
- May 06, 2021 04:34
这是一个很棒的功能!
我想知道参数键和值是否保留票证表格重新加载?

0
Juraj Jarmek
- 2021年5月6日11:17
你好Xiǎ奥林,

只要URL字符串被保留，如果页面被重新加载，这些值就会被保留。

希望这对你有帮助!

1
侯赛因Mithaiwala
- May 06, 2021 13:19
你好!

这个功能真的很好。

首先，如果只有一个表格，这个可以使用吗?也就是说我不需要在机票上填写身份证。

hc / en - us /请求/新的吗?tf_1260812645989 =

我只是想得到一个关于下拉值的想法，它说使用选项和值

如果我有一个有两个值的下拉框
Value = abc, tag = abc_test

Value = xyz, tag = xyz_test

使用我上面粘贴的url，这种情况下的url是什么?

谢谢你的帮助。

侯赛因

0
Kasper Sørensen
- May 06, 2021 15:57
亚博Zendesk产品经理
嗨@……，

在这种情况下，参数值将是选项值的标记。如果它是一个多选择字段，你也可以用逗号分隔这些标签。所以在你的情况下，它似乎是:
```
/ hc / en - us /请求/新吗?tf_1260812645989 =ABC_TEST,XYZ_TEST
```
0
侯赛因Mithaiwala
- 2021年5月6日16:11
嗨,卡斯帕

谢谢你的回复。

我确实尝试过你写的同样的方式，但是没有工作。

我会再试一次，如果成功的话会更新。

问候

侯赛因

0
达伦
- 2021年5月10日12:52
你好,

你是否需要一个富文本编辑器，或者你可以只使用例如word pad?

我不是一个开发人员，但这似乎很容易实现。

谢谢你！

0
Juraj Jarmek
- 2021年5月10日15:17
你好@……，

请注意，Word Pad确实是一个富文本编辑器。

如果你有微软账户，你也可以使用谷歌文档或微软Word在线版。

希望这能回答这个问题!

0
雅子K
- 2021年5月11日01:09
你好。
例如，如果票证表单中存在提交错误，重新显示的票证表单是否保留错误发生前的参数值?

0
Kasper Sørensen
- 2021年5月11日07:30
亚博Zendesk产品经理
如果表单提交失败，我们尝试保留提交时的值，而不是URL中预先填充的值。因为用户可以更改预填充的值。

0
迈克圆形石堡
- 2021年5月11日16:58
@……我为我们的帮助中心写了一些自定义代码前一天晚上看到这篇文章。虽然这是在浪费我自己的时间(哈哈/呜呜)，但它可能对你或任何不使用帮助中心的人有帮助。

免责声明:我更像是一个JavaScript/jQuery爱好者，而不是开发人员，所以使用风险由您自己承担。:)

添加下面的代码片段将允许您使用这样的链接预填充字段:

https://example.亚博zendesk.com/hc/en-us/requests/new?ticket_form_id=123&fields=request_custom_fields_456,tag1|request_custom_fields_789,tag2

只是交换123的表格编号，456和789用于您想要填写的自定义票务字段id，以及标签1和标签2对于与您希望为这些字段选择的选项相关联的标记。这种格式应该适用于您希望添加的任何数量的字段，无论是1个还是10个。

我专门为下拉自定义字段编写了这个脚本，但是您也可以为其他字段类型调整脚本。

无论如何，这是您想要添加到new_request_page的脚本。哈佛商学院的模板:
```
< >脚本
$(文档)时函数(){
Var url = window.location.href;
If (url.includes('fields') == true) {
var query字典= {};
location.search.substr (1) .split(“&”).forEach (
函数(项){
queryDict [item.split (" = ") [0]] = item.split (" = ") [1]
}
）
尝试{
var fields = queryDict.fields.split("|");
fields.forEach(函数(字段){
var thisField = field.split("，");
. getelementbyid (thisField[0])。value = thisField[1];
}）
}
catch {
}
}
}）;
> < /脚本
```
对于那些jQuery新手，你还应该确保你的页面设置使用jQuery添加如下内容:
```
< script src = " https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js " > < /脚本>
```
2
马特Heroux
- 2021年5月18日17:50
关于URL保留的问题—如果用户在返回表单之前绕过HC导航，看起来我们丢失了pass - through字符串—您打算解决这个问题吗?

0
Kasper Sørensen
- 2021年5月19日08:02
亚博Zendesk产品经理
嗨@……

这是有意为之。基于URL参数的预填充值仅在设置URL参数时有效。这样你就可以有不同的链接指向同一个表单，以不同的方式预填充它。

0
加勒特Galindo
- 2021年5月19日19:11
你好,

我试着让这个滚动，它似乎是不可能的，如果只有一种形式是在使用。我的帮助中心只允许在以下URL提交没有表单ID的内容。

为了使用如此简单的功能，我们是否需要升级我们的帐户?

亚博zendesk.com/hc/en-us/requests/new

0
王皮
- 2021年5月20日02:29
你好,

在GET请求参数中用用户信息预先填写表单时，有什么推荐的做法吗?

存储在服务器访问日志中的参数是否有泄露用户信息的风险?Zendesk在这亚博种情况下如何处理服务器访问日志?

谢谢!

0
Kasper Sørensen
- 2021年5月20日08:46
亚博Zendesk产品经理
嗨@……

不需要升级。你只需修改你的链接。例如，这里有一个到表单的链接上面写着你好，加勒特主题:-)

0
Kasper Sørensen
- 2021年5月20日08:51
亚博Zendesk产品经理
嗨@……

我不建议在任何URL中填写任何PII(个人身份信息)。很简单，因为很容易复制粘贴该URL，并意外地让您的用户以这种方式泄露信息。另外，我的直觉反应是，最好将这些信息存储在用户对象中，而不是票据中，但当然这里的用例有所不同。

关于我们的日志，请参考我们的数据删除策略。

0

亚历杭德罗结肠

2021年5月20日13:20

@……有没有办法加上一条新线?具体来说，在描述字段中。我尝试了以下方法，但没有成功:

ASCII字符	描述	url编码
空	null字符	% 00
全音阶	页眉开始	% 01
STX	文本开始	% 02
ETX	文本结束	% 03
测试结束	传输结束	% 04
询问	询盘	% 5
消	承认	% 06
贝尔	贝尔(环)	% 07
废话	退格	% 08年
HT	水平选项卡	% 09年
低频	换行	% 0 a
VT	垂直制表符	% 0 b
FF	换页	% 0 c
CR	回车	% 0 d
所以	移出	% 0 e
如果	的转变	% 0 f
DLE	数据链转义	% 10
DC1	设备控制1	% 11
DC2	设备控制2	% 12
DC3	设备控制3	% 13
DC4	设备控制4	% 14
钠钾共晶合金	否定应答	% 15
SYN	同步	% 16
ETB	端传输块	% 17
可以	取消	% 18
新兴市场	介质结束	% 19
子	替代	% 1
ESC	逃避	% 1 b
FS	文件分隔符	% 1 c
GS	组分隔符	% 1 d
RS	记录分隔符	% 1 e
我们	单位分离器	% 1 f

Kasper Sørensen
- 2021年5月21日07:24
亚博Zendesk产品经理
嘿，Alejandro，是的，这取决于你是否使用富文本编辑器或纯文本编辑器的描述字段。如果使用富文本，则应该提供HTML
标记，这样就可以有这样的参数
```
世界? tf_subject =你好< br >
```
1
亚历杭德罗结肠
- 2021年5月21日16:08
@……

非常感谢。我甚至没有想到这一点，即使我想出了一个复杂的方法来构建链接中的HTML段落。这样就简单多了，也更有意义了。

我认为这将是一个伟大的事情添加到文章中，因为我相信很多人都希望能够在预先填写的机票表格中添加新的行。

0
德米特里•Kozhanov
- 2021年5月26日10:17
嗨,伙计们,

谢谢你的伟大的功能。
但出于某种原因，这对我们的案子不起作用。

https://support.informationmapping.com/hc/en-us/requests/new?tf_subject=test

你能帮我吗?

谢谢!

0
Kasper Sørensen
- 2021年5月26日10:52
亚博Zendesk产品经理
嗨@……

如果我禁用javascript在您的网站，然后它的工作。我不知道具体是什么，但似乎你的主题定制在这里做了一些事情清除了表单或者妨碍了我们填充表单的逻辑。

0

请登录留下评论。