iTopCN – iTop 功能特性

Docs: 生命周期：转换时的标志

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍生命周期中状态转换时的字段标志配置。更多详细内容请参考 iTop 官方文档。

概述

自 2.4 版本起，当对象通过转换从源状态进入目标状态时，您可以定义在转换表单中哪些字段需要被记录（必填）、必须被更改或仅被提示。

状态上的标志

在状态上设置的 must_change、must_prompt 和 mandatory 标志适用于所有以该状态为终点的转换。

示例

例如，在一个工单（Ticket）上，有 3 个不同的转换以 assigned 状态为终点：

在 assign 转换期间，您希望提示用户输入必填的 agent（2.4 之前所有转换的默认行为）
在 re-assign 转换上，您希望强制更改 agent（自 2.4 起在 XML 中支持）
在门户上执行的 re-open 转换中，agent 字段甚至不应显示（自 2.4 起在增强门户中支持）
在 assigned 状态下，agent 在工单修改表单中应为只读模式，否则更改代理将不会触发与转换关联的操作（例如向新代理发送通知邮件）
一个字段现在可以在转换期间被设为必填，之前隐藏，之后只读，从而只允许具有允许运行该转换的角色的用户写入该字段

配置方法

示例 2：如何在 XML 中配置

<class id="UserRequest">
 <lifecycle>
 <states>
 <state id="assigned">
 <transitions>
 <transition id="ev_reassign">
 <target>assigned</target>
 <flags>
 <attribute id="agent_id">
 <must_change/>
 </attribute>
 <attribute id="team_id">
 <must_prompt/>
 </attribute>
 </flags>
 </transition>

iTop 行为

控制台上的转换表单会根据数据模型中定义的标志自动构建。在门户上，可以覆盖自动表单，但空的必填字段不能被移除。

适用于转换的标志

对于对象的每个字段，iTop 会组合在转换上设置的所有标志以及最终状态上定义的 Must_xxx 和 Mandatory 标志（并忽略最终状态上的其他标志，如 hidden、read_only、read_write）。

转换表单

按以下顺序检查标志，并在第一个匹配处停止：

must_change：以编辑模式显示，值必须更改且与之前不同
must_prompt：以编辑模式显示
最终状态或转换上的 mandatory，且初始值为空：以编辑模式显示
转换上的 read_only：以只读模式显示该字段
如果以上情况均不符合：不在表单中显示该字段

表单验证：

转换上、最终状态上或字段定义上的 mandatory 标志：强制要求填写该字段
否则，字段可以留空

状态上的修改表单

Must Change：强制在控制台上更改该字段（对门户无影响）
Must Prompt：对控制台和门户均无影响

门户：定义转换表单

增强门户支持按转换定义特定表单。

<form id="ticket-reopen" _delta="define">
 <class>UserRequest</class>
 <fields/>
 <twig>
 <div>
 <div class="form_field" data-field-id="public_log" data-field-flags="mandatory"/>
 <div class="form_field" data-field-id="team_id" data-field-flags="hidden"></div>
 <div class="form_field" data-field-id="agent_id" data-field-flags="hidden"></div>
 </div>
 </twig>
 <modes>
 <mode id="apply_stimulus">
 <stimuli>
 <stimulus id="ev_reopen"/>
 </stimuli>
 </mode>
 </modes>
</form>

与门户中定义的任何其他表单一样，您可以在字段上设置标志以：

向门户用户隐藏字段，即使该字段在控制台中被提示

<div class="form_field" data-field-id="xxxxx" data-field-flags="hidden"/>

强制门户用户在字段中输入值，即使该字段在控制台中不是必填的

<div class="form_field" data-field-id="xxxxx" data-field-flags="mandatory"/>

原文：https://www.itophub.io/wiki/page?id=3_2_0:feature:lifecycle

版本：3_2_0/feature/lifecycle.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 标识测试实例

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何标识 iTop 测试实例以及 iTop 标记功能。更多详细内容请参考 iTop 官方文档。

标识测试实例

iTop 默认使用 light-grey 主题来定义控制台的外观。我们添加了一个新主题 test-red，以便一眼识别您的测试实例。

如何更改主题

'backoffice_default_theme' => 'test-red',

更改控制台颜色

您可以通过扩展或（对于 Combodo 客户）使用 ITSM Designer 来修改控制台颜色。

iTop 标记（Markup）

从 2.7 版本起，我们在一些页面（控制台和门户）中添加了标记信息。

部分标记内容

对象详情上添加的标记：

class="object-details"
data-object-class="UserRequest"
data-object-id="34"
data-object-mode="view" 或 "edit"

对象详情中字段上添加的标记：

data-attribute-type="AttributeEnum"
data-attribute-code="status"
data-value-raw="new" — 对于枚举类型，这是代码而非翻译后的值

对象列表中行上添加的标记：

对象列表中字段上添加的标记：

自定义

借助添加的 HTML 标记，您可以编写简洁的代码来修改对象在 iTop 中的显示方式。例如：在控制台中高亮显示状态。

原文：https://www.itophub.io/wiki/page?id=3_2_0:feature:markup

版本：3_2_0/feature/markup.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 新闻中心

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 iTop 新闻中心功能。更多详细内容请参考 iTop 官方文档。

概述

新闻中心是 iTop 向当前用户显示新闻的地方。这些新闻可能来自各种新闻提供者。

从一开始，iTop Hub 就是一个新闻提供者，仅向 iTop 管理员发送新闻。
一些扩展提供者（如 Molkobain）也有自己的新闻提供者，仅当其某个扩展部署在该 iTop 实例上时，才向 iTop 管理员发送新闻。
自 iTop 3.2.0 起，iTop 本身也成为了一个新闻提供者，可以使用触发器-操作机制向任何后台办公用户发送新闻。

从用户的角度来看，新闻只是了解 iTop 中发生事件的另一种方式。对于整天在 iTop 后台办公中工作的用户，新闻可以替代电子邮件。

铃铛与新闻

新闻可通过左侧菜单栏底部显示的铃铛图标访问。

当有未读新闻时，铃铛上会显示红色圆点。
鼠标悬停在铃铛上时，会显示一个工具提示，显示新闻中心中"未读"新闻的数量（如果超过 99 条未读消息，则显示"99"）。
红色圆点和消息数量仅在用户在 iTop 中导航或重新加载当前页面时更新。
点击此图标会显示一个弹出菜单，其中包含消息。每条消息由图标和简短描述组成，实际上是指向更多信息的链接。
点击其中一条消息会在新标签页/窗口中打开消息的链接，并将消息标记为已读，从而将其从新闻中心菜单中移除。

管理员

iTop 社区管理员将接收来自两个不同新闻发布者的消息。每条消息右侧图标下方的标签提供了消息的来源（iTop Hub、iTop 或其他新闻发布者）。

查看所有消息

阅读、未读、查看、删除

点击铃铛，可以选择"查看所有消息"，这会打开一个用户专用页面。
如果您收到来自不同提供者的消息（只有 iTop 管理员会处于这种情况），则点击新闻提供者名称以查看来自该特定提供者的所有消息。

在该页面上，您可以：

删除收到的新闻
将新闻标记为未读，以便保持该状态，因为您仍需要回复或处理
将新闻标记为已读
在新浏览器标签页中打开新闻

批量管理

此外，通过更改"选择模式"，用户可以批量执行所有这些操作。

取消订阅通知

当用户由于 iTop 中特定类型的事件（在 iTop 术语中称为触发器）而收到新闻和/或电子邮件时，他现在可以决定取消订阅此类通知，前提是管理员已允许此类操作。

一个特定的触发器可以配置为向同一组人发送电子邮件和新闻。
每个收件人在收到至少一次通知后，可以决定取消订阅特定渠道，例如不再接收电子邮件，但保留新闻。
如果触发器设置允许，他们甚至可以完全取消订阅，移除所有渠道。

有两种路径可以打开此通知中心页面：一种是通过"我的新闻"页面右上角的图标，另一种是从用户偏好设置页面，点击链接。

最终进入用户专用页面，他们可以在其中管理通知订阅：

移除渠道和重新订阅时会提供反馈
当触发器不允许移除渠道时，会显示一条通用消息，不太容易与真正的原因关联起来

触发器和操作的配置人员可以限制用户取消订阅的可能性：

对于"提及"触发器，我们通常希望拒绝用户取消订阅所有渠道，他们将必须保留至少一个，以确保他们被通知。
对于某些操作（如 iCalendar 邀请、未经身份验证的表单等），用户根本不允许取消订阅。
用户只能取消订阅他们已经至少收到过一次通知事件的操作。
用户只能取消订阅直接发送到与其用户关联的联系人的操作，例如电子邮件和新闻，而不是 Rocket、Teams 等此类通知渠道。

配置新闻

负责配置 iTop 通知的用户可以创建新的"通过新闻中心通知"操作，这与"通过电子邮件通知"非常相似：

有关更多详细信息，请参阅通知页面。

发送的通知

当对象在创建或修改过程中生成了通知时，它们会在对象详情的专用标签页中可见（与之前一样）。这些通知按通知类型分组，标签更加清晰易懂。

新闻管理

新闻清理

有一个后台任务会删除已读新闻，这些新闻的保存时间超过配置参数 notifications.itop.read_notification_retention。默认值为 182 天
未读新闻永远不会被自动删除。

禁用新闻

管理员可以通过在 iTop 配置文件中将配置参数 newsroom_enabled 设置为 false 来禁用整个新闻中心机制（对所有用户），这将导致：

对所有用户隐藏铃铛
不会阻止 iTop 创建新闻，如果配置了"通过新闻中心通知"来生成新闻，但用户将很难看到它们。
停止所有其他新闻中心提供者从其对应的新闻发布者获取新闻（iTop Hub、扩展发布者如 TeemIp 或 Molkobain等）。

其他配置

notifications.itop.newsroom_cache_time：新闻中心铃铛后面通知消息列表两次刷新之间的间隔（分钟）。默认值为 5 分钟。
- 如果用户已读完所有新闻，那么刚创建的新闻将在不到此延迟的时间内通过在其铃铛上添加红色圆点显示给他们。
- 如果用户按下铃铛，缓存会立即清除，因此他们会获得其消息的准确当前状态。
notifications.itop.send_asynchronously：如果为 true，则 iTop 新闻中心通知将异步发送，除非在特定的"通过新闻中心通知"对象上另有设置。

用户偏好设置

用户偏好设置屏幕有一个部分供用户配置与新闻中心相关的一些参数：

已知问题：虽然在用户"偏好设置"页面中，下拉菜单中显示的消息数量似乎可以由每个用户配置，但此设置不会被保存。
每个新闻来源可以在同一用户"偏好设置"页面中启用或禁用。社区版本有两个新闻来源：iTop Hub、iTop 新闻。
- 但无法一次性禁用所有 iTop 发布的新闻，我们已将"显示来自 iTop 的消息"选项置灰。如果用户可以在选择了新闻中心作为"提及"触发器的唯一渠道时禁用所有来自 iTop 的消息，这将违背强制渠道始终处于活动状态的目的。
- 如果管理员取消选中"显示来自 iTop Hub 的消息"选项，其效果只会在他下次连接 iTop 时可见。

iTop Hub 新闻提供者

原文：https://www.itophub.io/wiki/page?id=3_2_0:feature:newsroom

版本：3_2_0/feature/newsroom.txt · Last modified: 2025/01/13 14:59 by 127.0.0.1

Docs: TagSet 与 EnumSet 属性

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 iTop 中的 TagSet 和 EnumSet 属性类型。更多详细内容请参考 iTop 官方文档。

概述

TagSet 和 EnumSet 是两种非常相似的不同属性类型。

它们在 UI 中的用法相同
允许标签的声明是主要区别：
- EnumSet：允许值在数据模型中声明
- TagSet：允许值是在每个 iTop 实例上声明的动态数据

如果您需要基于对象上是否存在特定标签来编写 PHP 行为代码，请使用 EnumSet，这样无论 iTop 上创建了什么数据，代码都可以被测试。

字段显示

在对象详情中它看起来是什么样子：

如果不确定标签的确切含义，只需将鼠标悬停在上面

TagSet 特有：如果您点击一个标签值，它会显示所有具有该特定标签的对象。

搜索此类字段

搜索具有 End-User 或 Agent 标签的 FAQ，或同时具有 End-User 和 Agent 标签的 FAQ。

搜索在用户门户上显示的通信（User Portal 是 portals EnumSet 允许值的标签）。

OQL 语法

对 TagSet 和 EnumSet 类型的字段进行搜索时使用特定的 OQL 语法。

假设您有两个代码为 agent 和 enduser 的域，以及一些带有这些标签的 FAQ：

您可以搜索具有这两个标签中任一标签的 FAQ：

SELECT FAQ WHERE domains MATCHES 'agent enduser'

您可以搜索同时具有两个标签的 FAQ：

SELECT FAQ WHERE domains MATCHES 'agent' AND domains MATCHES 'enduser'

您可以搜索没有任何标签的 FAQ：

SELECT FAQ WHERE domains = ''

搜索可以穿 S 或 M 码衣服的人：

SELECT Person WHERE cloth_size = '__S __M'

编辑此类字段

添加标签

如果可能标签数量较少，它们会列在下拉列表中。

如果您输入一些文本，可选值列表会过滤为包含您文本的那些。

如果只有一个值列出，按 Enter 键会将其添加到您的标签中。

当达到允许的最大标签数量时，可能的值列表将不再显示，因此您无法再添加值。如果在达到限制后移除一个标签，则可能的值列表将再次显示。

移除标签

如果您至少有一个已选标签并将光标放在该字段中：按 Backspace 键将移除最后一个标签。

如果您点击已选标签上的 x，它将移除该标签。

批量编辑 TagSet/EnumSet 字段

如果您具有批量写入权限，则可以大规模添加或移除标签。它支持以下用例：

向一组对象添加标签，并在所有修改的对象上保留其他标签不变。向已经具有该标签的对象添加标签没有效果。
从一组对象中移除标签，并在所有修改的对象上保留其他标签不变。从不具有该标签的对象中移除标签没有效果。

修改您想要批量添加或移除标签的对象列表：

这是标签在批量修改编辑屏幕中的显示方式：

在所有待修改对象上都存在的标签以白色背景显示
在至少一个待修改对象上存在的标签以灰色背景显示
- 如果您点击一个灰色标签，它会变成白色，并将被添加到所有待修改对象中
- 如果您保持灰色标签不变，它将保留在之前具有它的那些对象上，不会添加到其他对象上。
在待修改对象上都不存在但需要添加的标签，必须像单个对象编辑一样选择。
您可以按照单个对象编辑中描述的方式移除标签。

导出 / 导入

当您导出具有 TagSet 属性的对象时，标签会以其标签导出，用管道符 | 分隔。导入数据时也支持相同的格式。

您可以导出标签，或勾选"导出代码而非标签"标志来导出代码
您只能使用标签导入，目前不支持在控制台中使用代码导入。

针对上述限制的 EnumSet 变通方法：如果您必须有较短的标签（如鞋码或服装尺码），请在不使用的语言中定义较长的标签，并使用该语言的用户导入 CSV 的 EnumSet 字段。

管理 TagSet 允许值

添加允许标签

管理特定 TagSet 属性的建议值，与在 iTop 中管理分类（Typology）的方式相同。请参阅"数据管理"下的新菜单：

可以更改谁可以看到此菜单（与任何菜单一样），以及谁可以通过使用父类 TagSetFieldData 或子类（TagSetFieldDataFor_Class__AttCode）微调角色来修改这些类。

例如，如果您这样定义代码：

XS, S, M, L, XL, XXL

iTop 会将它们更改为：

_XS, __S, __M, __L, _XL, XXL

对于标签，它们不会被转换，但如果它们少于 3 个字母，则您无法在对象字段的 CSV 导入中使用此标签值。请参阅导出/导入部分。

搜索允许值

选择您要管理值的类/属性
检查现有值
创建缺失的值
代码只能使用数字和字母，不能使用其他字符。
标签按代码使用字母顺序排序：[1..9][A..Z][a..z]。

修改允许标签

如果没有对象使用该标签值，则可以自由修改。
如果至少有一个对象正在使用该标签，则代码不能更改，但标签和描述可以更改。

删除允许标签

如果没有对象使用该标签值，则可以自由删除。
如果至少有一个对象正在使用该标签，则不能删除。

首先从所有使用它的对象中移除该标签：

点击该标签
打开"标签使用"标签页
点击列出对象的修改操作
在批量编辑表单中移除标签并提交
现在您可以从面包屑导航中删除该标签

配置 TagSet 属性

作为标签定义的一部分，您必须定义：

给定对象上允许的最大标签数量 <max_items>。这不会限制可用标签的数量，可用标签数量没有限制。
您应该限制标签代码的大小以获得更好的性能 <tag_code_max_len>

常见问题

查询结果与内容不一致，我该怎么办？

尝试通过以 MySQL 用户身份执行 optimize table 语句来重建相应的 MySQL 表全文索引（请参阅相应文档）。

限制

“允许值"无法使用 TagSet 进行本地化，但使用 EnumSet 当然可以
当用户达到对象上允许的最大标签数量时，没有警告，只是停止建议新值
扩展 Data Localizer 尚未与 TagSet 测试
在具有实际数据的现有 TagSet 上减小 <max_items> 或 <tag_code_max_len> 的大小，将导致根据您的数据库产生不可预测的结果
TagSet / EnumSet 无法使用 Object Copier 复制

原文：https://www.itophub.io/wiki/page?id=3_2_0:feature:tag

版本：3_2_0/feature/tag.txt · Last modified: 2025/08/28 19:11 by 127.0.0.1