Outdated documentation

You are looking at the documentation for an older release. For the latest information, please see current release documentation.

动态字段

除了所有工单所需的一般信息外，组织还需要向工单中添加特定的细节。所需的信息采用各种格式，如文本、整数、日期时间等。

OTRS支持添加所谓的 动态字段 来处理文本、整数、下拉列表、多选择字段、日期-时间、复选框等。OTRS管理员可以定义哪些字段应该是可见的或可编辑的，当然，统计数据和报告中也可以使用动态字段。

使用此屏幕管理系统中的动态字段。默认情况下，一个新的OTRS安装包含三个动态字段。动态字段管理屏幕可在 流程和自动化 组的 动态字段 模块中使用。

管理动态字段屏幕

管理动态字段

若要创建一个新动态字段：

1. 从左侧边栏中选择一个对象，并从其下拉列表中选择一个动态字段类型。
2. 填写必填字段。
3. 点击 保存 按钮。

创建新动态字段屏幕

若要编辑一个动态字段：

1. 点击动态字段列表中的一个动态字段。
2. 修改字段。
3. 点击 保存 或 保存并完成 按钮。

编辑动态字段屏幕

若要删除一个动态字段：

1. 点击概览表最后一列的垃圾桶图标。
2. 点击 确认 按钮。

删除动态字段屏幕

注解

如果向系统添加了多个动态字段，可使用过滤器框通过键入要过滤的名称来查找特定的动态字段。

警告

The maximum number of 300 valid dynamic fields should not be exceeded. Exceeding this limit may affect the system performance.

动态字段设置

添加或编辑此资源时，可以使用以下设置。 标有星号的字段是必填字段。

动态字段通用设置

所有类型的动态字段的这些设置都相同。

动态字段通用设置屏幕

名称 *

此资源的名称。 可以在此字段中输入任何类型的字符，包括大写字母和空格。 名称将显示在概览表中。

标签 *

这是在激活了该字段的屏幕上显示的名称。

参见

可以为动态字段标签添加翻译。 必须手动将标签翻译添加到语言翻译文件中。

字段顺序 *

这是在激活了该字段的屏幕上显示的顺序。

有效性 *

设置此资源的有效性。 如果此字段设置为 有效，则每个资源即可仅在OTRS中使用。 将此字段设置为 无效 或 临时无效 将禁止此资源的使用。

字段类型

此类型已在上一页面中选择，不再在此处更改。 这是一个只读字段。

对象类型

此类型已在上一页面中选择，不再在此处更改。 这是一个只读字段。

注解

对象类型确定可以使用动态字段的位置。 例如，对象类型为 工单 的动态字段只能在工单中使用，不能在信件中使用。

以下设置仅与特定类型的动态字段相关。

复选框动态字段设置

复选框动态字段用于存储 true 或 false 值。

复选框动态字段设置

默认值 *

复选框的默认值。

已选中

默认情况下，复选框已选中。

未选中

默认情况下，复选框未选中。

联系人信息动态字段设置

此动态字段允许添加联系人信息到工单。

联系人信息动态字段设置

姓名字段 *

Name 属性始终是必需的，并且不会自动添加，因此对于每个新数据源，必须手动添加此属性。 在数据源定义（或动态字段配置）中，它们必须由键 Name 表示，值可以是 Name 之类。

ValidID 字段 *

ValidID 属性始终是必需的，并且不会自动添加，因此对于每个新数据源，必须手动添加此属性。 在数据源定义（或动态字段配置）中，它们必须由键 ValidID 表示，值可以是 Validity 之类。

其它字段

这些是联系人可能的数据属性。 点击 添加字段 中的 ⊞ 按钮将添加两个新字段，其中可以设置 键 （内部值）和 值 （显示值）。 使用该按钮，您可以添加多个键值对。

警告

Name 和 ValidID 键已被 姓名字段 和 ValidID 字段 使用。 不要再使用这两个键！

添加字段

使用此按钮可以向动态字段添加更多字段。

必须的字段

以逗号分隔的必须的键列表。

注解

Name 和 ValidID 键始终是必须的，不必在此列出。

排序字段

以逗号分隔的排序顺序键列表。 此处列出的键首先出现，之后是所有剩余字段，并按字母顺序排序。

可搜索的字段

以逗号分隔的可搜索的键列表。

注解

Name 键始终是可搜索的，不必在此处列出。

可翻译的值

如果激活此选项，这些值将被转换为用户定义的语言。

注解

您需要将翻译手动添加到语言翻译文件中。

保存动态字段后，单击概览表中新创建的字段的名称。将打开 编辑动态字段 屏幕。 有一个 添加或编辑联系人 按钮，指向 工单 → 编辑联系信息 以添加一些数据。

联系信息管理屏幕

若要添加新的联系信息：

1. 从左侧边栏的 操作 小部件的下拉列表中选择一个动态字段。
2. 点击左侧边栏中的 添加联系信息 按钮。
3. 填写必填字段。
4. 点击 保存 按钮。

添加联系信息屏幕

若要编辑一个联系信息：

1. 点击联系信息列表中的一个联系信息。
2. 修改字段。
3. 点击 保存 或 保存并完成 按钮。

编辑联系信息屏幕

这种动态字段的使用比其他字段更复杂。 联系人信息的示例性用法如下：

1. 创建一个联系人信息类型的新动态字段。
2. 设置可能的联系属性（可能值）。
   • 在 姓名字段 中输入 Name。
   • 在 ValidID 字段 中输入 Validity。
   • 使用 添加字段 添加任何其他属性，例如 Telephone 属性（键：Telephone，值：Phone）。
3. 添加以逗号分隔的必须的属性键列表（不需要 Name 和 ValidID）。
4. 将属性键顺序列表逗号分隔为：Name,Telephone,ValidID。
5. 添加可搜索的属性键列表（不需要 Name），以逗号分隔。
6. 通过在主导航栏中使用 工单 → 编辑联系人信息 屏幕，在新创建的数据源中添加至少一个联系人来填充数据源。
7. 将新的动态字段添加到应显示的屏幕配置中。 例如，通过更新系统配置设置 Ticket::Frontend::AgentTicketPhone###DynamicField 和 Ticket::Frontend::AgentTicketZoom###DynamicField，添加到 创建电话工单 屏幕中。
8. 转到 创建电话工单 屏幕，注意新字段出现了。 将所有需要的信息添加到工单。
9. 使用自动完成选择现有联系人，并选择一个联系人。
10. 分配的联系人及其属性将会显示在 工单详情 屏幕。
11. 可以通过单击联系人信息框标题右侧显示的 编辑联系人信息 按钮来更新联系人的属性（如果当前用户是系统配置设置 Frontend::Module###AdminDynamicFieldContactWithData 中定义的组的成员）。
12. 如果需要更改此工单的联系人，则可以通过配置了显示此动态字段的任何其他工单操作来完成。

日期动态字段设置

日期动态字段用于存储一个日期值。

日期动态字段设置

默认的日期差

用与 当前 的差值（以秒为单位）来计算本字段的默认值（例如3600或-60）。

定义年期

激活此功能可定义要在字段的年份部分显示的固定年份范围（将来和过去）。 如果设置为 是，则可以使用以下选项：

过去的几年

在编辑屏幕选择这个动态字段的年份时，能选择从当天算过去的几年。

未来的几年

在编辑屏幕选择这个动态字段的年份时，能选择从当天算未来的几年。

注解

If no years period is specified, the system uses the default value for the period: 10 years (5 years in the past and 5 years in the future).

显示链接

Here you can specify an optional HTTP link for the field value in overviews and zoom screens. Examples:

• The value of dynamic field named Field1 is part of the link:

  https://some.example.com/handle?query=[% Data.Field1 | uri %]
  

• The value of dynamic field named Field1 is the complete link with and without protocol:

  [% Data.Field1 | uri %]
  https://[% Data.Field1 | uri %]
  

• The value of dynamic field named 100Field needs special handling, because the name of the dynamic field starts with a number:

  https://some.example.com/handle?query=[% Data.item("100Field") | uri %]
  

• The value of dynamic field named Field1 contains the link, the value of dynamic field named Field2 contains an important value for a parameter:

  https://[% Data.Field1 | uri %]?query=[% Data.DynamicField_Field2 | uri %]
  

If special characters (&, @, :, /, etc.) should not be encoded, use url instead of uri filter.

预览链接

如果填写了内容，在工单详情屏幕中当鼠标移动到这个URL上方时将显示URL的预览。请注意：要使这个功能生效，还需要上面的常规URL字段也填写好了内容。

限制输入日期

在这里可以限制输入工单日期。

防止未来的日期条目

选择此选项将阻止输入当前日期之后的日期。

防止过去的日期条目

选择此选项将阻止输入当前日期之前的日期。

日期/时间动态字段设置

日期/时间动态字段用来存储一个日期时间值。

日期/时间动态字段设置

此类动态字段的设置与日期动态字段的设置相同。

下拉框动态字段设置

下拉框动态字段用于存储一个封闭列表中的单个值。

下拉框动态字段设置

可能值

这些是联系人可能的数据属性。 单击 ⊞ 按钮将添加两个新字段，其中可以设置键（内部值）和值（显示值）。 使用该按钮，您可以添加多个键值对。

警告

The maximum number of 100 values should not be exceeded. Exceeding this limit may affect the system performance.

默认值

这是此字段的默认值，这将显示在编辑屏幕上。

添加空值

如果激活此选项，则会定义一个额外值，以在可能值列表中显示为 -。 此特殊值在内部为空。

树形视图

Activate this option to display values as a tree. If you use a sub-value, specify it as Parent::Sub.

可翻译的值

如果激活此选项，这些值将被转换为用户定义的语言。

注解

您需要将翻译手动添加到语言翻译文件中。

显示链接

Here you can specify an optional HTTP link for the field value in overviews and zoom screens. Examples:

• The value of dynamic field named Field1 is part of the link:

  https://some.example.com/handle?query=[% Data.Field1 | uri %]
  

• The value of dynamic field named Field1 is the complete link with and without protocol:

  [% Data.Field1 | uri %]
  https://[% Data.Field1 | uri %]
  

• The value of dynamic field named 100Field needs special handling, because the name of the dynamic field starts with a number:

  https://some.example.com/handle?query=[% Data.item("100Field") | uri %]
  

• The value of dynamic field named Field1 contains the link, the value of dynamic field named Field2 contains an important value for a parameter:

  https://[% Data.Field1 | uri %]?query=[% Data.DynamicField_Field2 | uri %]
  

If special characters (&, @, :, /, etc.) should not be encoded, use url instead of uri filter.

预览链接

如果填写了内容，在工单详情屏幕中当鼠标移动到这个URL上方时将显示URL的预览。请注意：要使这个功能生效，还需要上面的常规URL字段也填写好了内容。

多选框动态字段设置

多选框动态字段设置

可能值

这些是联系人可能的数据属性。 单击 ⊞ 按钮将添加两个新字段，其中可以设置键（内部值）和值（显示值）。 使用该按钮，您可以添加多个键值对。

警告

The maximum number of 100 values should not be exceeded. Exceeding this limit may affect the system performance.

默认值

这是此字段的默认值，这将显示在编辑屏幕上。

添加空值

如果激活此选项，则会定义一个额外值，以在可能值列表中显示为 -。 此特殊值在内部为空。

树形视图

Activate this option to display values as a tree. If you use a sub-value, specify it as Parent::Sub.

可翻译的值

如果激活此选项，这些值将被转换为用户定义的语言。

注解

您需要将翻译手动添加到语言翻译文件中。

文本框动态字段设置

文本框动态字段用于存储一个单行字符串。

文本框动态字段设置

默认值

这是此字段的默认值，这将显示在编辑屏幕上。

显示链接

Here you can specify an optional HTTP link for the field value in overviews and zoom screens. Examples:

• The value of dynamic field named Field1 is part of the link:

  https://some.example.com/handle?query=[% Data.Field1 | uri %]
  

• The value of dynamic field named Field1 is the complete link with and without protocol:

  [% Data.Field1 | uri %]
  https://[% Data.Field1 | uri %]
  

• The value of dynamic field named 100Field needs special handling, because the name of the dynamic field starts with a number:

  https://some.example.com/handle?query=[% Data.item("100Field") | uri %]
  

• The value of dynamic field named Field1 contains the link, the value of dynamic field named Field2 contains an important value for a parameter:

  https://[% Data.Field1 | uri %]?query=[% Data.DynamicField_Field2 | uri %]
  

If special characters (&, @, :, /, etc.) should not be encoded, use url instead of uri filter.

预览链接

如果填写了内容，在工单详情屏幕中当鼠标移动到这个URL上方时将显示URL的预览。请注意：要使这个功能生效，还需要上面的常规URL字段也填写好了内容。

正则表达式检查

您可以在这里指定一个正则表达式来检查值，正则表达式将使用 xms 修饰符执行。例如：

^[0-9]$

添加正则表达式

点击 ⊞ 按钮将添加两个新字段，可以添加一个正则表达式和一条错误消息。

多行文本框动态字段设置

多行文本动态字段用于存储一个多行的字符串。

多行文本框动态字段设置

行数

此字段在编辑模式中的高度（行）。

列宽

此字段在编辑模式中的宽度（单位：字符）。

默认值

这是此字段的默认值，这将显示在编辑屏幕上。

正则表达式检查

您可以在这里指定一个正则表达式来检查值，正则表达式将使用 xms 修饰符执行。例如：

^[0-9]$

添加正则表达式

点击 ⊞ 按钮将添加两个新字段，可以添加一个正则表达式和一条错误消息。

数据库动态字段

注解

要使用这种类型的动态字段，需要 OTRS 服务软件包。 请联系sales@otrs.com进行升级。

Web服务动态字段

注解

要使用这种类型的动态字段，需要 OTRS 服务软件包。 请联系sales@otrs.com进行升级。

在屏幕中显示动态字段

若要在一个屏幕中显示一个动态字段：

1. 确保该动态字段的 有效性 设置为 有效。
2. 在系统管理界面中打开 系统配置 模块。
3. Navigate to Frontend → Agent → View or Frontend → External → View and select a view to add the dynamic field to.
4. 找到以 ### DynamicField 结束的设置，然后单击 编辑这个设置 按钮。
5. 点击 + 按钮添加动态字段。
6. 在文本框中输入动态字段的名称，然后单击勾选按钮。
7. 选择 1 - 启用 或 2 - 启用且必填。
8. 点击右侧的勾选按钮以保存设置。
9. 部署修改后的系统配置。

在屏幕中显示动态字段

注解

可以同时添加多个动态字段。 为此，请重复步骤5-7。

Add Dynamic Fields to Search Engine

By default, the content of the dynamic fields cannot be searched using the document search functionality. Each dynamic field has to be added manually.

To add a dynamic field to the document search functionality:

1. 转到 系统配置 屏幕。
2. Navigate to Frontend → Agent → DocumentSearch and Frontend → External → DocumentSearch in the navigation tree.
3. Search for the setting DocumentSearch::Agent::DynamicField and DocumentSearch::External::DynamicField respectively.
4. Click on the Edit this setting button.
5. 点击 + 按钮添加动态字段。
6. 在文本框中输入动态字段的名称，然后单击勾选按钮。
7. Select 0 - Disabled or 1 - Enabled.
8. 点击右侧的勾选按钮以保存设置。
9. 部署修改后的系统配置。

通过工单事件模块设置默认值

如果该字段还没有值，则工事件（例如 TicketCreate）可以触发某个字段的值设置。

1. 在系统管理界面中打开 系统配置 模块。
2. Navigate to Core → Event → Ticket and search for the setting Ticket::EventModulePost###9600-TicketDynamicFieldDefault.
3. 点击 编辑这个设置 按钮以激活设置。
4. 点击右侧的勾选按钮以保存设置。
5. 部署修改后的系统配置。

激活工单事件模块

范例：在 TicketCreate (创建工单)事件中激活 Field1：

1. 在系统管理界面中打开 系统配置 模块。
2. Navigate to Core → Ticket → DynamicFieldDefault and search for the setting Ticket::TicketDynamicFieldDefault###Element1.
3. 点击 编辑这个设置 按钮以激活设置。
4. 点击右侧的勾选按钮以保存设置。
5. 部署修改后的系统配置。

在创建工单事件中激活动态字段

注解

这个配置可以在16个 Ticket::TicketDynamicFieldDefault###Element 设置的任何一个中设置。

参见

如果需要设置超过16个字段，则必须将自定义XML文件放在 $OTRS_HOME/Kernel/Config/Files/XML 目录中以扩展此功能。

通过用户首选项设置默认值

可以使用存储在个人首选项中的用户定义值覆盖动态字段默认值。

1. 在系统管理界面中打开 系统配置 模块。
2. Navigate to Frontend → Agent → View → Preferences and search for the setting PreferencesGroups###DynamicField.
3. 点击 编辑这个设置 按钮以激活设置。
4. 点击右侧的勾选按钮以保存设置。
5. 部署修改后的系统配置。

在个人首选项中激活动态字段

单击左上角的头像，然后选择 个人首选项 → 杂项 以添加动态字段的默认值。

个人首选项中的动态字段

此设置是如何在用户首选项屏幕中创建一个条目以便为所选用户设置独占动态字段 Name_X 的默认值的示例。 此设置的限制是它只允许使用一个动态字段。 如果两个或多个字段将使用此功能，则需要创建自定义XML配置文件以添加与此类似的更多设置。

注解

如果在新XML中添加了更多设置，则每个设置名称在系统中必须是唯一的，并不同于 PreferencesGroups###DynamicField。 例如：

• PreferencesGroups###101-DynamicField-Field1
• PreferencesGroups###102-DynamicField-Field2
• PreferencesGroups###My-Field1
• PreferencesGroups###My-Field2