iTopCN – New Releases

Blog: iTop 3.2 新特性

Sun, 24 Nov 2024 00:00:00 +0000

iTop 3.2 社区版

3.2.0 Beta 版本发布日期：2024年6月
3.2.0 发布日期： 2024年 9月
3.2.1 发布日期：2025年3月
3.2.2-1 发布日期：2025年8月
3.2.3 发布日期：2026年4月
下载链接
iTop变更历史列表：累积的变更日志
升级前须知：迁移说明
开发者迁移须知：迁移扩展到3.2
Combodo 3.2 适配的插件版本

本文已根据 iTop 官方文档更新至 3.2.3。下文首先介绍 3.2.0 带来的主要能力，并标注后续 3.2.x 版本补充的开发特性。

iTop 社区版新特性

对于用户

消息

现有的消息空间功能已扩展到所有 iTop 后台用户。之前该功能仅限于 iTop 管理员和外部消息提供者，如 iTop Hub。

从这一版本开始，iTop 成为一个 消息提供者，这意味着当 iTop 中发生某些事件时，它可以向目标用户发送消息。

这一功能使用了现有的触发器-动作机制。新增的 动作通知 类型允许发送消息，可以替代或与电子邮件并行发送。

消息会显示给目标 iTop 用户，在 iTop 后台中，通过铃铛图标展示。
铃铛上的红点会通知用户有未读的消息。
当用户点击其中一条消息时，它会打开动作中指定的 URL，一般是触发该消息的对象。消息会自动标记为已读，并附上日期。

用户可以查看所有收到的消息，并逐一或批量处理：

用户可以标记消息为已读或未读。
用户可以删除消息。
无论是否已读，消息都会在经过 iTop 配置的保留时间后自动删除，默认保留为 60 天。

这些消息通知只能发送给有权限访问 iTop 后台的用户。

通知中心

后台用户现在可以 取消订阅 特定的通知。

我们这里所说的 通知，是指特定触发器和动作的组合。

举例：管理员可能已经配置了
- 针对日志更新的触发器，通过电子邮件和消息通知工程师。
- 以及另一个针对位置创建的触发器，通过消息通知某些人。
在这种情况下，工程师将能够：
- 在邮件和消息之间选择 对于第一个触发器，如果触发器允许，甚至可以取消订阅所有通知。
- 取消订阅 位置创建触发器的消息，如果对他没有用处的话。

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

对于 对象提及时 触发器, 通常希望禁止用户取消订阅所有通道，他们必须至少保留一个通道，以确保他们收到通知。
对于某些动作，如日历邀请、未经认证的表单等，用户不允许取消订阅。
用户只能对于可接收到至少一个通知事件的通知动作取消订阅。
用户只能对直接发送给链接到他们用户关联的联系人（如电子邮件和消息）的动作取消订阅，而不能取消订阅 Rocket、Teams 等其他通知通道。

HTML文本编辑器

iTop 使用了一个外部提供的工具，叫做 CKEditor，出于维护和安全原因，这个工具需要升级。新版本与之前的版本有很大不同，大部分编辑功能得到了保留，并且有不同的图标，部分功能丢失，新增了一些功能。

新的HTML编辑器工具栏

在新工具栏中找回以前的功能

这个新版本的编辑器在格式化表格方面比以前更强大，但和任何新版本一样，使用它需要一些时间来适应。

提示与技巧

如何退出嵌入代码的部分？按三次“Enter”键。
当你将之前的工单日志复制粘贴到新的工单日志中时，背景颜色会保留，这样很难去掉。为了避免这种情况，可以使用快捷键 Ctrl+Shift+V，只粘贴纯文本而不带格式。如果你熟悉 HTML，可以点击 源代码 按钮，直接编辑 HTML 代码并去掉 div 标签。

新的控制台主题

为了确保 iTop 的可访问性，我们的团队为后台开发了新的主题。这些主题符合 WCAG 标准，专为视觉障碍用户设计，使他们更容易使用该解决方案：

色盲主题：专为色盲用户设计，实际上分为两种子主题，以适应特定情况：
- 一种适应红绿色盲和绿黄色盲（protanopia & deuteranopia）
- 另一种适应蓝黄色盲（tritanopia）
高对比度主题：增强对比度，帮助用户更容易地区分屏幕上的不同元素。对于色盲以外的低视力用户也有帮助。

欢迎弹出窗口

Combodo 和 iTop 扩展的编辑者现在可以决定向某些用户（通常是管理员，也可以是所有用户）显示与新版本相关的消息。

在 iTop 升级后，用户首次登录时可能会看到多个消息
这些消息一旦被用户确认后，将不再显示
在 iTop 3.2 中，所有用户会看到四条消息，只有 iTop 管理员会看到一条专门的消息

按钮的行为：

稍后提醒我：将在下次登录 iTop 时再次显示所有消息
下一步：确认当前消息已读并显示下一条消息（如果是最后一条，则关闭窗口）
点击弹窗外的区域，将关闭弹窗，下次登录 iTop 时未确认的消息将再次显示

新的门户搜索

在终端用户门户中默认添加了一个搜索框，允许用户检索他们的工单，无论其状态如何。

对于管理员

数据模型访问

在控制台显示的任何 iTop 对象的类标签，管理员可以点击该标签，跳转到该类的数据库模型页面。

通知

围绕通知做了多项改进，主要包括以下内容：

消息空间

此版本带来了一个新的操作，通过消息通知后台用户。

该操作可以通过任何触发器触发。
开箱即用，通过 消息通知 操作会自动创建，查看详细信息：
- 一个方面，用于向任何在 iTop 对象中被提及的人发送消息（iTop 会检索任何已存在的 被提及触发器 并将其与新的操作关联）
- 一个方面，用于通知工单的工程师，但这个操作没有链接到任何触发器，它只是一个示例
触发该操作将为每个拥有关联活跃用户的收件人生成一条消息

异步操作

大多数操作都新增了一个异步字段，用于指定是否应立即触发并在未完成时阻止用户，或者在后台执行，或者遵循全局的 iTop 设置。

订阅策略

触发器现在可以定义是否允许用户取消订阅所有通信渠道、除了一个 或没有，默认设置是 允许完全取消订阅。

对于像 对象体积是 和 审批请求时 这样的触发器，最好更改此设置。

操作中的最后执行记录

在操作对象中添加了一个新的 Ajax 标签（以异步方式显示，作为仪表盘属性）: 最后执行。

它将显示该特定操作的日志。默认情况下，显示 61 天的记录，但可以通过 notifications.last_executions_days 配置参数进行修改

类标签重命名

为了更清楚地区分 操作（Action）（指定如何执行特定操作）和 事件（Event）（表示操作执行结果），我们已经重新命名了大多数属于 Action 和 Event 的类。

对于开发者

新的事件

在3.2.0中，增加和移除了一些事件

移除

EVENT_DB_BEFORE_APPLY_STIMULUS
EVENT_DB_AFTER_APPLY_STIMULUS
EVENT_DB_APPLY_STIMULUS_FAILED

增加

EVENT_DB_ABOUT_TO_DELETE: 删除已确认并将发生。对象及其关系仍可在数据库中用于 OQL 查询和 Get(‘att_code’)
EVENT_ENUM_TRANSITIONS: 管理当前对象状态中允许的转换。唯一允许的操作是使用 $this→DenyTransition($sTransitionCode) 拒绝转换。

新的 XML 配置（3.2.1 起）

从 iTop 3.2.1 开始，AttributeDate 和 AttributeDateTime 可以使用 XML 中的 <default_value> 为表单预填日期，并在通过 PHP 直接创建对象时设置默认值。

支持使用 OQL 日期表达式，例如：

<default_value>NOW()</default_value>

<default_value>DATE_ADD(NOW(), INTERVAL 7 DAY)</default_value>

NOW()：使用对象创建时的当前日期或时间。
DATE_ADD(NOW(), INTERVAL 7 DAY)：使用当前日期或时间加 7 天。
也可以使用其他受 OQL 支持的日期计算表达式。

这些配置可以提前部署到较旧版本的 iTop 中，但在升级到支持该能力的版本前不会生效。

新的API

\iBackupExtraFilesExtension

允许（通过扩展或代码片段）指定额外的文件和目录，与标准文件（配置文件、数据库备份等）一起添加到 iTop 备份归档中。

Example

class MyFilesToAddToBackupArchive implements \iBackupExtraFilesExtension
{
 public function GetExtraFilesRelPaths(): array
 {
 return [
 // A file saved in the data folder
 'data/file1.txt',
 // A file saved in a module in the current environment ("production" most of the time)
 'env-'.\utils::GetCurrentEnvironment().'/some-module/file2.txt',
 // A file from the log folder
 'log/file3.txt',
 ];
 }
}

`\iWelcomePopupExtension`

该接口允许扩展或代码片段在后台用户登录时显示欢迎消息。只要用户尚未确认，消息就会在后续登录时继续显示。

推荐继承已经提供默认实现的 \AbstractWelcomePopupExtension，并通过 GetMessages() 返回消息列表。配合 MessageFactory 可以创建多种布局：

左侧标题和说明、右侧插图
左侧插图、右侧标题和说明
包含完整 HTML 的说明内容
在说明中嵌入视频等富媒体内容

每条消息都应使用稳定且唯一的 ID，以便 iTop 正确记录用户是否已经确认该消息。

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

官方页面最后更新：2026/04/30

Blog: iTop 3.1.0 新特性

Sat, 16 Sep 2023 00:00:00 +0000

iTop 3.0 社区版

3.1.0 Beta 版本发布日期：2023年6月
3.1.0 发布日期： 2023年 8月
下载链接
升级须知：迁移说明
开发者迁移须知：迁移扩展到3.1
iTop变更历史列表：累积的变更日志
3.0.0 版本已知问题列表

iTop 社区版新特性

这个版本专注于改进iTop后端控制台的用户体验。

同义词区分

摘要卡片

有时，仅仅通过对象的名称并不能够清晰地识别，这种情况下，将鼠标悬停在该对象的名称上，停留一段时间，那么，会在弹出窗口中会显示有关该对象的更多信息，并有可能直接在全屏模式下编辑该对象。

人员

Multiple other classes do have a summary by default, more details.
You can add a summary on your own classes as well…

许多其他的类默认情况下都有摘要，更多详情。
你也可以在自定义的类上添加摘要…

补充名称

在下拉列表中选择对象时会非常有用：

人员（电子邮件 + 组织名称）
触发器（类别，附加信息）

许多其他类别也具有补充名称，更多详情。

关系

我们简化了创建、添加、修改、移除和删除相关对象的方式，提供这些操作而无需编辑当前对象。

1:n 视图模式

如果用户拥有权限，他们可以在详细信息视图中添加和删除子对象，而无需编辑当前对象本身。

以工单为例，用户可以在工单上创建、修改或删除相关联的工作任务。

创建

修改

删除

只要用户允许编辑和删除工作任务，不管是否允许修改用户请求，上述操作对他都将是可用的。

n:n 视图模式

It’s now possible to add and remove related objects from the details view, without editing the current object it-self, which means that a user can do it even if he is not allowed to modify the current object, as long as he is explicitly allowed to modify the relationship or at least the remote class.

现在可以在详细视图中添加和删除关联对象，而无需编辑当前对象本身。这意味着，只要用户明确允许修改关系或至少远程类，即使不允许修改当前对象，他也可以执行这些操作。

以团队为例，我们希望：

添加一个人员，

修改角色

或者从团队中移除

像标签集一样的 n:n 关系

iTop 3.1 版本引入了一种新的方式来处理多对多关系，这些关系没有属性，也不期望包含许多相关对象。

用户 - 用户角色

例如，一个用户可以与几个角色关联，通过这项新功能，可以在对象的“属性”选项卡中选择角色，这样更容易记得填写它们。

限制

仍然没有视觉指示：关系是必填且未填写
当在弹出界面中创建/修改对象时，关系选项卡不会显示，因此无法选择任何允许的组织。

在 3.0.0 版本中，用户到角色关系上有一个备注字段，可以用于指定何时以及为什么分配了该角色，甚至可以是用户请求的参考，证明了该访问权限。但另一方面，没有办法对删除的角色进行备注。
现在可以从用户日志中进行备注。

通知 - 触发器

另一个例子，当创建/编辑电子邮件通知时，可以在通知的“属性”选项卡中直接选择触发器。

如果想要的触发器尚不存在，可以从这里创建它。

创建后，它将添加到弹出窗口中的 相关触发器 字段中。

如果对这种新模式不太熟悉，关系的反向部分仍然会使用选项卡显示。

这种其他视图仍然允许设置排序关系字段。

n:n 编辑

这些按钮已移到列表的右上角。

门户中的 n:n

可以在用户标准门户中编辑多对多（n:n）关系的属性。

有一些属性类型是不受支持的，其约束与后台用户界面中是相同的：

多行属性（HTML、长文本、案例日志等）
文件和图片
标签集和枚举集
关联集

可以在门户XML中指定链接类属性的有序列表，以限制用户门户可见的属性。

链接字典

与链接相关的操作/图标提示、弹出窗口标题和确认消息，可以根据类别/属性进行定制和专门化。

过滤列表

现在可以在每个列表中（数据表列表、对象关系选项卡、运行查询结果等），可以点击：

列表计数：总计：X 个对象
或使用新的操作菜单 使用搜索条件显示列表…

这两个链接将在全屏模式下打开相同的查询，带有相应的搜索条件集。

然后，可以更改过滤器以减少结果，
运行菜单“配置此列表”以修改显示的字段，等等。

对于多对多关系选项卡，查询包括链接及其字段。
它还提供了对这些链接和相关对象的批量操作。

多类别的批量操作

当返回的对象列表包含多个类别的对象时，对于那些在这些类别上拥有批量修改权限的用户，会提供不同的新操作。对于每个类别，如果用户允许操作，它会提供：

批量编辑
批量删除

您可能会在显示在对象详细信息中的多对多关系选项卡中遇到这种情况。这样的列表包含两个类别，链接和远程类别。

可以在以下情况下遇到这种情况，即在以下位置输入多类别 OQL：

仪表盘列表
运行查询
快捷方式

例如，在三个类别上运行查询的情况：

数据模型变化

新的布局

通知：新的布局

触发器：新的列表

用户：新的布局和工具提示

人员：添加了用户选项卡，当然，只有允许查看用户类别的用户才能看到它。

如果人员的组织已经关联了“门户用户”，而且新的组织不允许该用户，那么就不能再更改该组织，因为这将会破坏用户访问 iTop 的权限。

问题管理：新的详情页布局

3.0 layout	3.1 layout aligned to the User Request fields order and columns

客户合同和供应商合同：新的详细信息页面布局，具有两列和三个字段集。

链接上的唯一性规则

在所有标准数据模型的多对多链接上都添加了唯一性规则。

如果想在自定义链接上执行相同的操作，请查看迁移说明部分。

枚举值排序

新的XML标签允许定义给定枚举属性应如何显示其值。请参阅如何排序枚举属性的值

转换顺序

现在可以通过配置参数和标准数据模型中的工单类别上添加的默认排序来排序带有生命周期的类别的转换。

转换表单

转换表单中的字段顺序现在会自动遵循类别详细信息选项卡中设置的顺序。与详细信息界面的设置顺序保持一致。

委托历史记录

现在可以允许没有管理员角色的 iTop 用户查询对象历史记录，只需为他们提供一个带有新组History的角色，或者使用由扩展Admin tools delegation带来的Query History角色。

此外，请注意这样的用户不应该拥有“允许的组织”，并且应该具有对所有启用历史记录跟踪的类别的读取访问权限，因为出于安全原因，如果他们没有这些权限，它不是绝对安全的，通过历史记录可以以碎片的形式查看所有这些对象，了解它们的更改情况。

CSV import

Feedback during CSV import have been improved, when reconciliation on enumeration value or external key are failing

On enumeration, in case of no match, the allowed values are displayed
On external key, in case of no match,
- some of the existing values are displayed and a search button is proposed to check by yourself in another window
- if there is no entries in iTop (or no entries visible to the current user), a message will tell you:
  - There are no ‘Organization’ objects
  - There are no ‘Organization’ objects found with your current profile

CSV导入

在CSV导入期间，当枚举值或外部键的匹配失败时，反馈得到了改进

在枚举值的情况下，如果没有匹配项，将显示允许的值
在外部键的情况下，如果没有匹配项，
- 将显示一些现有值，并提供一个搜索按钮，以便在另一个窗口中自行检查
- 如果在iTop中没有条目（或当前用户无法看到条目），将显示以下消息：
  - 没有’组织’对象
  - 没有找到与您当前配置文件匹配的’组织’对象

登出

现在会自动返回登录界面

审计

新仪表盘

配置审计的新仪表盘

以下的改进是由Combodo的由来已久的合作伙伴Itomig贡献的。非常感谢Lars Kaltefleiter！

审计分割

按领域分割审计：

用户只能查看与自己领域相关的审计，不会被那些不是他们负责修复的错误所干扰
提高了审计性能，甚至在iTop的数据增长如此之大以至于在合理时间内审计永远无法结束的情况下，恢复了审计能力
限制审计计算量，限制为对请求审计用户有意义的内容

对于每个审计类别的结果，拥有足够权限的人可以使用“扳手”图标跳转到审计类别对象，以根据需要调整规则。
对于Combodo的客户，包括超链接配置器，可以直接从这些对象中测试审计领域、类别或规则的结果。

可配置的阈值

按类别配置的阈值颜色

现在可以在每个规则中定义结果良好、一般或不佳的阈值。

查询语句

在查询短语中添加了新信息，以跟踪每个查询的使用情况，以便可以清除不再使用的查询：

总使用次数
上次用户
上次使用日期

对于管理员

通知

电子邮件通知已增强，新增了以下字段：

一个语言字段，允许在指定的语言中翻译占位符，而不是触发通知的用户的语言。
一个 HTML模板 文件，允许发送漂亮的HTML电子邮件，而不会丢失包含占位符的可能性。请注意，现在可以进行预览。
一个 忽略通知标志 字段。如果设置为“否”，它将自动从TO、CC和BCC中删除通知设置为“否”的人员。不再需要在OQL中包含此逻辑。

使用令牌进行身份验证

此模块提供了两种使用身份验证令牌进行API调用的方式：

应用程序令牌 是iTop中的一种特殊类型的用户。
- 它使用令牌进行身份验证，无法连接到iTop用户界面（控制台、门户等）
- 它有自己的角色和允许的组织
- 它可以访问所有API（REST、同步、导出等），没有可能的限制
个人令牌 与iTop用户关联
- 它使用令牌进行身份验证，无法连接到iTop用户界面（控制台、门户等）
- 它继承自其关联的用户、角色和允许的组织
- 它可以限制到一些AOI（例如，仅支持REST和导出）
- 它的个人令牌管理可以委托给具有特殊角色的用户

如果公司的安全策略要求每个用户通过SSO SAML进行身份验证，那么个人令牌是不支持SSO SAML访问的iTop API的解决方案。用于Excel或PowerBI动态报告的导出是其中之一。

查看令牌身份验证模块以获取更多详细信息

密码过期

您已经定义了密码策略，但这不适用于现有密码。您可以批量更新iTop用户，强制他们更改密码，以确保他们的新密码符合策略。

现在，如果愿意，可以通过设置此模块配置参数 password_expiration_delay 强制iTop本地用户定期更改密码。

查看密码过期管理模块以获取更多详细信息。

用户管理委托

如果将用户管理委托给非管理员，他们将无法看到管理员用户。要恢复以前的行为，请将配置参数 security.hide_administrators 设置为 false。

自动清理日志

大型系统记录了大量数据。实际的日志系统允许轮换日志文件以防止内容过大，但服务器磁盘上仍然保留了所有文件。我们添加了一个定期任务来删除旧文件并释放服务器磁盘空间。由两个新参数控制：

log_purge.enabled，布尔类型，默认值为false
log_purge.max_keep_days，整数（以天为单位），默认值为365

在最终用户标准门户中进行调试

以前，要在门户中访问调试消息，必须激活门户调试模式。为了简化故障排除，现在可以通过日志配置来激活调试消息，就像对应用程序的任何其他部分一样。

文件属性/附件下载通知

在ormDocument对象（文件属性、附件）中添加了一个下载计数器：

迁移后，计数器从0开始，即使对于以前已经下载过的现有文档。
在附件表中（在对象详细信息中）显示计数器。
不在AttributeBlob上显示计数器。

文件属性

现在提供了一个新的“触发器（在对象文档下载时）”，当有人在后台或最终用户门户中下载文件属性（例如“文档文件”类中的“文件”）时，它将激活。

此触发器使您可以在操作中访问新的占位符（当然，标准占位符仍然可用）：

$file->mime_type$ 文件的MIME类型（例如：“image/png”）
$file->file_name$ 文件的名称，如上传时
$file->downloads_count$ 文件被下载的次数。请注意，这是在当前下载之前的计数，因此可以hook一些检查以防止超过阈值。
$file->data$ 文件的二进制内容
$file->data_as_base64$ 文件的Base64编码内容，对于与其他应用程序的集成可能会很有用

附件

现在提供了一个新的“触发器（在对象附件下载时）”，当有人在后台或最终用户门户中下载附件时，它将被激活。

此触发器使您可以在操作中访问新的占位符（当然，标准占位符仍然可用）：

$attachment->xxx$ 与 $this->xxx$ 相同，但使用附件本身（$this 是它附加到的对象）
$attachment->mime_type$ 文件的MIME类型（例如：“image/png”）
$attachment->file_name$ 文件的名称，如上传时
$attachment->downloads_count$ 文件被下载的次数。请注意，这是在当前下载之前的计数，因此您可以钩住一些检查以防止超过阈值。
$attachment->data$ 文件的二进制内容
$attachment->data_as_base64$ 文件的Base64编码内容，对于与其他应用程序的集成可能会很有用

请注意 $xxx->data$ 和 $xxx->data_as_base64$ 的输出可能会很大。

重新启动安装程序

在以前的版本中，要启动安装程序，必须修改配置文件权限，因此需要访问服务器文件系统。

现在，在“应用程序升级”屏幕中提供了一个按钮（从 PR #244 集成）。

该按钮的可用性取决于 isdevenv 属性的组合（请参见\utils::IsDevelopmentEnvironment）和 setup.launch_button.enabled 配置参数。请参考下表查看列表（❌ = 未定义值，👻 = 隐藏，💻 = 显示）：

setup.launch_button.enabled	isDevEnv	按钮
❌	false	👻
true	false	💻
false	false	👻
❌	true	💻
true	true	💻
false	true	👻

对于开发者

自定义模块：model.*.php 文件声明

在编写模块时，即使 model.*.php 文件未由iTop编译生成，也可以指定该文件（在 module.*.php 文件中的 ‘datamodel’ 键中）。

此外，如果模块中存在 datamodel.*.xml 文件，编译器将自动选择它以生成相应的 model.*.php 文件。

从iTop 3.1.0开始，不再需要声明 model.*.php 文件（在 module.*.php 文件中的 ‘datamodel’ 键），因为编译器将通过自动加载程序，自动将其添加到datamodel中。

自定义模块：对/pages/exec.php 的调用，现在允许在页面参数中使用子目录

exec.php 脚本用于执行模块内的脚本。例如，Ajax端点。

使用此脚本，现在可以指定要执行的脚本和子目录。例如：exec.php?exec_module=mymodule&exec_page=ajax/endpoint.php&exec_env=production

请参见PR＃221。

自定义模块：使用自己的自定义zlists

有时需要一个自定义zlist，其中包含一组有限/特定的属性列表。从iTop 3.1+开始，现在可以定义自己的自定义zlist，并像标准zlist一样使用它们，使用\MetaModel::GetZListItems()。有关更多详细信息，请参见此处。

对象详细信息URL：使用attcode/attvalue访问

自2.7.0以来，引入了一种生成ref字段的新方法。这可能导致ref和id字段的值不同。

当从外部系统构建对象详细信息URL时（例如Bugtraq），这可能会导致问题，因为参数是类和id。

已存在的解决方法是将friendlyname值发送到id参数…但这仅在friendlyname只包含ref以外的字段时才可能。

为了解决friendlyname包含多个字段（标题、org等）的情况，现在可以在控制台和用户门户中使用新的URL。例如，对于具有id=99和ref=100的对象：

/pages/UI.php?operation=details&class=UserRequest&id=99
/pages/UI.php?operation=details&class=UserRequest&attcode=ref&attvalue=R-000100
/pages/exec.php/object/view/UserRequest/99?exec\_module=itop-portal-base&exec\_page=index.php&portal\_id=itop-portal
/pages/exec.php/object/view/UserRequest/ref/R-000100?exec\_module=itop-portal-base&exec\_page=index.php&portal\_id=itop-portal

如果未找到实例或找到多个实例，则会出现以下情况：

管理控制台：将抛出异常。
用户门户：将显示404错误页面。

请参见 PR #273。

原文：https://www.itophub.io/wiki/page?id=3_1_0:release:whats_new

版本：3_1_0/release/whats_new.txt · Last modified: 2023/09/11 13:35 (external edit)

Blog: iTop 3.0 新特性

Tue, 13 Sep 2022 00:00:00 +0000

iTop 3.0 社区版

==================

3.0.0 Beta 版本发布日期：2021年4月
3.0.0 发布日期： 2022年 1月
3.0.1 发布日期： 2022年 4月
3.0.2 发布日期： 2022年 9月
下载链接
升级须知：迁移说明
iTop变更历史列表：累积的变更日志
3.0.0 版本已知问题列表
检查扩展 3.0 适配版本

iTop 社区版新特性

============================

这个版本专注于改进iTop的外观和 可用性。

首页

不能错过的主要内容：布局、颜色、图标、菜单…… 所有这些都完全改变了，更可读，给重要信息留下更多空间，突出重要的东西，所以可以更高效。

可能的操作的主要变化:

在iTop中任何位置一键访问欢迎面板
添加了一个新的快速创建操作，以避免搜索相应的类创建菜单。
快速搜索从右侧移动到左侧，在界面的上方。
菜单可以简化成图标，从而为实际数据释放空间。
用户菜单移动到屏幕另一侧的角落了!

快速搜索

快速搜索现在在左侧。

主要的新特性是 它记录了过去的搜索记录
与以前一样，当重新打开快速搜索时，最后的搜索仍然在那里，因此如果犯了一个拼写错误，可以修复它，而无需重新输入整个字符串。

现在可以通过新的配置参数配置该特性 global_search.xxx，这允许：

完全禁用这个功能
删除过去搜索的踪迹和显示
优化过去搜索操作保留的数量（默认为10）

快速创建

全新功能：

它允许快速创建任何对象，甚至不知道菜单在哪里，如果有的话。

只需键入所需类的开头，系统就会推荐与之匹配的类。

如果只有一个匹配的类，只需按回车键，就会显示该类的创建表单。
可以使用键盘上的方向键来浏览建议列表

现在可以通过配置参数配置该特性 quick_create. .xxx，这允许：

完全禁用这个功能
删除过去创建的踪迹和显示
优化过去创建操作保留的数量（默认为10）
优化通过自动补全特性显示的结果数量（默认为10）

对象显示

3.0 版本提升了对象显示的形式：

标头和操作

标头部分已经完全重做：

突出显示重要信息，如对象状态
为每一类对象使用特定的颜色，以便在任何时候都更清楚地显示所处位置。
锁定了顶部栏，所以即使当你向下滚动一个对象时，操作仍然可以访问，不适合所有的浏览器窗口
用富有意义的图标替换文本菜单，为重要数据腾出空间
将转换操作从其他操作中分离出来，因此它们更容易检索
显示对象的图标可以特定于显示的实例，以便更好地区分

活动面板

工单日志独立编辑

添加了一个新的面板，以加速处理人只需要在日志记录中提供回复并可能应用变化的常见情况。

为此，他不需要修改工单，而是可以直接输入答复并发送它，同时如果需要，只需单击一次就可以应用变化。
这个新选项只存在于控制台中，适用于所有具有工单日志的对象。
现在可以通过XML对象声明来控制工单日志的顺序。

详情见用户手册

历史过滤

在命名为“活动面板”的这部分屏幕中，可以检索日志和历史，它们都合并在一个时间轴中，这能更有效地了解完整的历史。

可以过滤此面板，以查看任何类型的条目
- 日志条目，你可以过滤更多，只查看评论或私信。
- 状态变化 无论何时的对象的状态改变
- 编辑当对象创建或修改时(包括发送的通知)
在条目旁边，如果用户有头像，则显示用户头像，否则显示用户姓名的首字母。

历史时间戳是 相对近的时间 和 绝对高于 某指定的延迟。

历史显示能够配置，通过新的活动面板参数。

提及用户

在控制台中，处理人可能希望快速通知工单日志中的某个人，以引起他们的注意。

那个人可能与工单没有关联，但我们仍然想通知他们。
只需输入 @ 和姓名的开头，就会提示可用人员。
然后在提交包含 提及 的工单日志条目时，该人将收到一封电子邮件通知。
同一工单日志中可以提及多个人。
建议在工单上提及的人默认是属于
- 这个工单的客户组织
- 或者与当前用户相同的组织。
这个逻辑可以通过修改通知改变。

列表

还记得在列表中滚动时失去列标题是多么痛苦吗?这回结束了，当你向下滚动时，现在他们仍然是可见的。

同时，用于筛选列表的搜索条件仍然显示在屏幕上。

还可以注意到与状态值相关的彩色圆圈。

用户指南-管理列表.

仪表盘

已经改进了仪表盘的外观，有新的图标和图表

基于状态的组件头部统计使用了与每个值相关的颜色，以使其更容易阅读
仪表盘徽章已简化，以更好地突出显示计数和类名，并删除链接中无用的重复文本

仪表盘特定的菜单已经得到了协调，因此在查看仪表盘的标准版本时，只要有了自定义版本，版本模式就会应用于自定义版本，这一点更容易理解。
查看详情见这里

气泡的工单日志

在用户门户中显示工单日志更加时髦：

—-

菜单

菜单有丰富的图标，可以缩小显示图标，从而为有价值的信息获得空间

欢迎

快速回到iTop首页的方法！

上方左侧图标过去绝不会带你到想去的地方，我打赌，
现在它将带你返回到iTop首页，默认回到欢迎面板！
这个图标能够在XML中自定义，作为 品牌 部分

对象统计

预定义查询中的对象数

精确的对象数量显示在菜单本身，
99+ 代表多于99条。

菜单查询

在Chrome的快捷键 Alt+M ，能够不使用鼠标在菜单中进行搜索
然后输入一些字符过滤包含字符的菜单
空格字符，显示所有菜单

展开 & 折叠

使用汉堡包图标展开和折叠菜单的第一层。
当菜单栏展开后，分组的图标旁边显示了文字。
想要折叠菜单栏，点击图标。
当菜单栏折叠时，如果过滤了某个组织，则会显示一个红色圆圈。

关系

in read and edit mode are now identical in terms of displayed fields.
It’s much faster now to replace a team member by another one, just by editing their name. This new logic is available on all many to many relationships.

在读取和编辑模式下的关系显示现在在显示字段方面是相同的。

现在用另一个人替换一个团队成员要快得多，只需要编辑他们的名字。这种新的逻辑适用于所有多对多关系。

用户首选项

3.0版本带来了新的用户首选项来控制iTop的行为，所以你可以选择最适合你的习惯的模式。

你可以控制iTop对象的显示时间：

布局，能够控制选项卡标题显示在顶部(与之前一样) 或者在左侧。
导航: 只显示单个选项卡的内容(与之前一样)或所有选项卡同时显示，要么在其他选项卡下面，允许使用简单的鼠标滚动导航
新的选项使每次编辑一个HTML字段时打开工具栏
新的选项使你可以在不修改工单本身的情况下，直接能够在工单的工单日志中输入一些东西。

如果你喜欢用键盘快速导航，为频繁的动作添加了快捷方式。

查看如何管理你的用户首选项。

Fullmoon 或者 Darkmoon

选择主题，饱满或者暗淡, 与你的心情一致。

预定义的OQL查询

安装时

在安装时(新安装或版本升级)，一组在通知中可用的OQL查询会自动加载。
查询标签和描述使用iTop默认语言，如果存在翻译 (EN US, FR FR 和 DE DE)
对于每个要加载的查询，对于OQLQuery标记iTop查询作为Template for OQL fields，并且有完全相同的 Expression (OQL)。
- 如果有一个和一个已经存在，那么没有新的查询被加载，并且现有的查询没有更新。
- 如果没有找到，则创建一个新的OQLQuery
- 如果发现多个，则创建一个新的iTop(已知 iTop 限制)

通知中的使用

OQL查询标记为Template for OQL fields，建议在编辑任何类型为OQL的iTop字段时，作为一个新的操作来检索现有的查询，并轻松地从选定的OQL查询复制OQL。
可以创建自己的模板查询，
你可以修改OQL查询模板自动加载的标签和描述。
OQL查询模板中OQL的修改对过去使用OQL查询作为源的通知没有影响。这些通知保留了查询的旧版本。

用户管理

多个 LDAP

iTop现在原生支持连接到多个 LDAP 服务器的能力。

Admin自毁灭

以下的修改是为了 阻止管理员 或者用户 提交自毁灭.

用户不能禁用自己的账号

用户不能删除允许他编辑用户帐户的最后一个角色。
如果用户至少有一个允许的组织，则其联系人必须将其组织包含在用户允许的组织列表中。

用户不能删除自己的账号。
用户不能移除关联到自身账号的联系人。
允许访问后台的用户不能向自己的用户帐户添加“门户角色”或任何其他角色，这将阻止他再访问后台。

如果必须执行上述任何操作，则必须由另一个用户执行。

如果你实现了用户代理，然后一个新的配置参数允许改善这些用户的体验，通过防止他们编辑管理员和获得错误消息，通过简单地向他们隐藏那些管理员用户。查看 security.hide_administrators 配置参数。

集成

Webhooks

允许任何已存在的触发器

发送聊天通知到Google Chat, Rocket.chat 和 Slack, 同时发送email通知到相同的利益相关者。
复制/镜像另一个itop对象的部分，通过一个操作的json中的简单配置，并更新本地触发对象的远程信息
调用任何提供web服务的第三方应用程序

关于此特性的更多详细信息包含在3.0.0产品中，并作为iTop 2.7.x上的扩展

系统

安装

由于视图产生的问题比它带来的价值更多(视图的表名称超过MySQL的限制等等)，它们从3.0.0版本被删除
在安装过程中，所有与定义的业务模型类对应的 view__ClassName_ 都将被系统地删除。

REST/JSON

在CLI模式下，JSON数据结构现在可以放在一个单独的文件中，在命令行中，您只需提供文件的路径，就像这样：json-data@.

监控

监控：允许监控itop状态，无需通过任何认证HTTP

新的定制

分组菜单图标

定义菜单图标。如果没有图标，则使用标签的第一个字母。

设置类的颜色和图标

随着iTop 3.0，现在可以通过iTop扩展或ITSM设计器

定义类的颜色：这个颜色用于对象细节、列表和一些组件的顶部栏。
定义类的图标用于自定义类，或更改现有类的图标。
对于某些类，比如Person，显示在对象标头上的图标可以是特定于每个对象的。这里只需要定义示例 icon，指定要使用的对象AttributeImage字段。

设置枚举值的颜色

iTop 3.0，现在可以对任意枚举字段的每个值定义颜色和字体图标。

创建你自己的主题

iTop 3.0，甚至更容易去定义自己的iTop主题，在现有的基础上或在原地。
每个用户都可以在安装的软件中选择自己想要的主题。

丰富对象的友好名称

有时一个友好名称不足以区分两个对象，特别是当您想在下拉列表中选择它时。为了应对这一问题，iTop 3.0带来了一个新的概念，去区分同音异议词.

对于开发者

新的DBObject方法

在DBObjects上，增加了新的方法，所有类上都是可用的
主要的用处是，对于XML开发者和ITSM Designer用户在无须编写代码的情况下，修改变化上的属性
SetCurrentDateIfNull, AddValue, SetComputedDate, SetComputedDateIfNull

查看详情，请参见可用的方法，在变化上作为操作可以使用。

记录对已弃用文件/ PHP方法的调用

3.0.0中增加了一个新的日志文件：log/deprecated-calls.log。

这将包含调用已弃用文件或PHP方法的日志，并将帮助开发人员迁移他们的代码。实际上iTop API的一部分标有 @deprecated 通常会在下一个iTop主要版本移除：即iTop 3.0.0中一个方法标记为@deprecated则肯定会在iTop 3.1.0确定被移除。

默认情况下，这些日志是禁用的，但可以使用log_level_min配置参数为适当的日志通道启用它们。此外，如果在GitHub克隆上使用记录器将有不同的行为。

查看参考对应的文档。

在向导安装中预编译主题

这个功能是对设置的优化，可以为主题节省大量时间(每个主题大约30秒)。

更多的细节，查看主题预编译。

新的 developer_mode.enabled 配置参数

一些针对扩展和核心开发人员的iTop行为是由 \utils::IsDevelopmentEnvironment 方法触发的：Twig 缓存重置, setup symlinks, DeprecatedCallsLog, …

这个方法只对Github克隆返回true。

现在是新的 developer_mode.enabled 参数允许控制方法返回值:如果参数有一个布尔值，那么它将被用作方法返回值，否则现有的行为将被保留。 331/5000 现在是新的“developer_mode”。启用的config参数允许控制方法返回值:如果参数有一个布尔值，那么它将被用作方法返回值，否则现有的行为将被保留。

默认的配置参数值是 null 所以除非设置了显式值，否则不会发生任何更改。

生成 symlinks 标记

此选项仅在满足以下所有条件时可用:

运行在一个开发环境中 (当直接使用iTop GitHub仓库克隆时，或者当 developer_mode.enabled configuration parameter 设置为true时)
symlink PHP 功能可用

如果在这样的环境中启动安装程序，则会在安装程序中显示一个新选项，在 “Miscellaneous Parameters” 向导安装中：

当编译完成并选中该选项时，创建 /data/.compilation-symlinks 文件。此外，如果该文件存在，设置复选框将被选中。对应的选项在3.0.0 toolkit中也是一样的。

注意，当编译从任何没有向编译器(\MFCompiler::Compile)提供useSymLinks参数的客户端启动时，这个文件将被用来生成符号链接。如ITSM设计器连接器、集线器连接器、调用RuntimeEnvironment的自定义脚本。

这对扩展开发人员来说是一个好处:如果您正在使用带有符号链接选项的工具包进行开发，并且需要启动设置，那么将直接获得符号链接。在此之前，必须使用toolkit重新编译以获取符号链接。

编译器总是生成新的 model.*.php

在iTop 3.0.0中自提交c5d265f6 ，现在当需要写入一个model.*.php文件时，编译器将总是会移除当前的文件。这代表着model.*.php 文件将不再作为symlink生成。

如果编译是使用符号链接选项完成的，下面是这种行为更改结果的简短总结:

有 model.*.php	有 datamodel.*.xml	结果
✔	❌	➖ 在原始模型文件中所做的修改将需要在iTop中推送一个新的编译
✔	✔	➖ 同上 ➕ 如果模型是来源于版本(Git, Svn, …)的，在model.*.php中将不能得到编译的代码
❌	✔	➕ 同上

原文：https://www.itophub.io/wiki/page?id=3_0_0:release:3_0_whats_new

版本：3_0_0/release/3_0_whats_new.txt · Last modified: 2022/09/13 14:25 (external edit)

iTopCN – New Releases

Blog: iTop 3.2 新特性

iTop 3.2 社区版

iTop 社区版新特性

对于用户

消息

通知中心

HTML文本编辑器

提示与技巧

新的控制台主题

欢迎弹出窗口

新的门户搜索

对于管理员

数据模型访问

通知

消息空间

异步操作

订阅策略

操作中的最后执行记录

类标签重命名

对于开发者

新的事件

新的 XML 配置（3.2.1 起）

新的API

\iBackupExtraFilesExtension

\iWelcomePopupExtension

Blog: iTop 3.1.0 新特性

iTop 3.0 社区版

iTop 社区版新特性

同义词区分

摘要卡片

人员

补充名称

关系

1:n 视图模式

n:n 视图模式

像标签集一样的 n:n 关系

用户 - 用户角色

通知 - 触发器

n:n 编辑

门户中的 n:n

链接字典

过滤列表

多类别的批量操作

数据模型变化

新的布局

更多的工具提示

通知

菜单

对象标签页

链接上的唯一性规则

枚举值排序

转换顺序

转换表单

委托历史记录

CSV import

CSV导入

登出

审计

新仪表盘

审计分割

可配置的阈值

查询语句

对于管理员

通知

使用令牌进行身份验证

密码过期

用户管理委托

自动清理日志

在最终用户标准门户中进行调试

文件属性/附件下载通知

文件属性

附件

重新启动安装程序

对于开发者

自定义模块：model.*.php 文件声明

自定义模块：对/pages/exec.php 的调用，现在允许在页面参数中使用子目录

自定义模块：使用自己的自定义zlists

对象详细信息URL：使用attcode/attvalue访问

Blog: iTop 3.0 新特性

`\iWelcomePopupExtension`