Outdated documentation

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

管理员界面¶

本软件包没有管理员界面，但是可以在服务人员和外部人员界面中使用该功能。可以配置以下屏幕：

服务人员界面：

创建电话工单
新的邮件工单
工单呼入电话
工单呼出电话
工单备注
工单关闭
工单转移
工单挂起
工单自定义字段
工单所有者
工单负责人
工单优先级

外部人员界面：

新建工单
工单回复（在 工单详情视图 中）

如果使用了非特定于工单的ACL，则在 工单搜索 屏幕中，该功能仅限于显示或隐藏动态字段（例如 属性→用户→用户ID 或角色）。

注解

This feature works with ticket dynamic fields only. Other dynamic field object types are not supported.

示例用法¶

目标：

如果选择了品牌 VW（大众），则所有动态字段均应隐藏，仅显示 VW Model。
如果选择了大众车型 Up，则应显示除 标致车型 和 标致生产设施 字段外的所有动态字段。

创建以下动态字段：

对象	类型	名称	标签	可能值
工单	下拉选择框	`Brand`	品牌	`VW` → VW（大众） `Peugeot` → Peugeot（标致）
工单	下拉选择框	`VWModel`	大众车型	`Up` → Up `Polo` → Polo `Golf` → Golf `T5` → T5
工单	下拉选择框	`VWProductionFacility`	VW Production Facility（大众汽车生产设施）	`Barcelona` → Barcelona（巴塞罗那） `Berlin` → Berlin（柏林） `Bratislava` → Bratislava（布拉迪斯拉发）
工单	下拉选择框	`PeugeotModel`	Peugeot Model（标致车型）	`207` → 207 `307` → 307
工单	下拉选择框	`PeugeotProductionFacility`	标致生产设施	`Poissy` → Poissy（普瓦西） `Madrid` → Madrid（马德里） `Trnava` → Trnava（斯洛伐克特尔纳瓦）
工单	下拉选择框	`Fuel`	燃料	`Gasoline` → Gasoline（汽油） `Diesel` → Diesel（柴油） `Gas` → Gas（天然气）
工单	多选框	`Accessories`	配饰	`CDRadio` → CD Radio `GPS` → GPS `ProximitySensors` → Proximity Sensors(接近传感器) `RearCamera` → Rear Camera（后置摄像头） `ClimateControl` → Climate Control(温度控制)
工单	多行文本	`Remarks`	评论
工单	日期	`RegistrationDate`	注册日期
工单	日期	`InvoiceDate`	发票日期

通过设置 Ticket::Frontend::AgentTicketPhone###DynamicField 将动态字段添加到 新建电话工单 屏幕：

Brand → 1 - Enabled
VWModel → 1 - Enabled
VWProductionFacility → 1 - Enabled
PeugeotModel → 1 - Enabled
PeugeotProductionFacility → 1 - Enabled
Fuel → 1 - Enabled
Accessories → 1 - Enabled
Remarks → 1 - Enabled
RegistrationDate → 1 - Enabled
InvoiceDate → 1 - Enabled

导入此ACL：

---
- ChangeBy: root@localhost
  ChangeTime: 2019-07-22 11:44:25
  Comment: ''
  ConfigChange:
    PossibleNot:
      Form:
      - PeugeotModel
      - PeugeotProductionFacility
      - Accessories
      - Fuel
      - Remarks
      - RegistrationDate
      - InvoiceDate
  ConfigMatch:
    Properties:
      Ticket:
        DynamicField_Brand:
        - VW
  CreateBy: root@localhost
  CreateTime: 2019-07-22 11:40:43
  Description: ''
  ID: 1
  Name: ACL-VW
  StopAfterMatch: 0
  ValidID: 1

详细说明：

DynamicField_Brand:
- VW

此ACL规则的条件。如果选择了品牌 VW（大众），则规则将生效。数组包含使用的可能值。这些是数据库中 dynamic_field 表 config 列中的键。在本例中，它是一个类型为下拉的动态字段。

Form:

这个软件包在 Possible、PossibleAdd 和 PossibleNot ACL 变更部分引入了 Form 键作为新选项。Form 保存动态字段可见性的配置。

PossibleNot:
  Form:
  - PeugeotModel
  - PeugeotProductionFacility
  - Accessories
  - Fuel
  - Remarks
  - RegistrationDate
  - InvoiceDate

本节列出了不可见的动态字段。在此示例中，动态字段 VW Model（大众车型） 和 VW Production Facility（大众汽车生产设施） 是可见的。所有其它动态字段将被隐藏。

导入第二个ACL：

---
- ChangeBy: root@localhost
  ChangeTime: 2019-07-22 12:06:24
  Comment: ''
  ConfigChange:
    Possible:
      Ticket:
        DynamicField_Accessories:
        - CD Radio
        - Climate Control
        DynamicField_Fuel:
        - Gasoline
        DynamicField_VWProductionFacility:
        - Bratislava
    PossibleAdd:
      Form:
      - Accessories
      - Fuel
      - Remarks
      - RegistrationDate
      - InvoiceDate
    PossibleNot:
      Form:
      - PeugeotModel
      - PeugeotProductionFacility
  ConfigMatch:
    Properties:
      Ticket:
        DynamicField_Brand:
        - VW
        DynamicField_VWModel:
        - Up
  CreateBy: root@localhost
  CreateTime: 2019-07-22 11:47:02
  Description: ''
  ID: 2
  Name: ACL-VW-Up
  StopAfterMatch: 0
  ValidID: 1

详细说明：

DynamicField_Brand:
- VW
DynamicField_VWModel:
- Up

在此示例中，应满足两个条件。品牌必须是 VW（大众），而大众车型必须是 Up，此规则才能生效。仅当服务人员选择品牌 VW 并且 Up 车型时才会触发。

PossibleAdd:
  Form:
  - Accessories
  - Fuel
  - Remarks
  - RegistrationDate
  - InvoiceDate

在这里，VW Model 和 VW Production Facility 的动态字段已经可见并保留，但是 Accessories（配饰）、Fuel（燃料）、Remarks（评论），注册日期 和 发票日期 必须重新添加到可见的字段。这是在 PossibleAdd 部分中完成的，因为第一个ACL将该字段设置为未显示，并且两个ACL一起工作。例如，如果在 Possible 部分中进行了此操作，结果将是仅显式显示这些字段，并且 VW Model 和 VW Production Facility 将被隐藏，因为它们不再属于（新的） Possible 部分。

PossibleNot:
  Form:
  - PeugeotModel
  - PeugeotProductionFacility

只有 标致车型 和 标致生产设施 是不可见的（在我们的示例中，如果用户是大众 Up 车，则配置标致车型没有多大意义）。

除了动态字段的可见性之外，还可以仅显示动态字段的某些可能值。像在这里这样结合到ACL规则中，可以更轻松地处理大型多选。

Possible:
  Ticket:
    DynamicField_Accessories:
    - CD Radio
    - Climate Control
    DynamicField_Fuel:
    - Gasoline
    DynamicField_VWProductionFacility:
    - Bratislava

在我们的示例中，大众 Up 仅具有CD收音机和温度控制作为附加配饰，仅以汽油作为燃料，并且只在布拉迪斯拉发生产。

例如，如果我们有标致207的ACL规则，则可能还有其他配饰、燃料选项和生产地点可供选择。

注解

如果使用基于 DynamicField_NameX 值的 Possible 选项显示动态字段，通常需要包含触发ACL成为要在 Possible 或 PossibleAdd 部分（如果应用）中显示的字段的一部分的动态字段。否则，如果 Possible 或 PossibleAdd 包含其它字段且不是触发器，则在选择该值后将不显示最新的字段。

注解

不能使用此方法更改字段的强制状态。