iTopCN – How to 示例

Docs: 门户定制

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

本文档介绍 iTop 门户定制。自 iTop 2.3 起，增强版门户提供了丰富的定制选项，可通过 XML 配置和扩展实现个性化需求。更多详细内容请参考 iTop 官方文档。

概述

自 iTop 2.3 版本起，增强版门户提供了丰富的定制选项，允许您根据最终用户的需求进行个性化配置，几乎无需编码。

门户定制能力

通过门户定制，您可以实现：

访问权限控制：通过 XML 定义哪些用户/角色可以访问门户
菜单定制：自定义门户中的导航菜单
表单定制：控制对象的显示方式、字段布局和可见性
外观定制：修改主题、颜色和图标
扩展功能：通过开发新的 Brick（功能模块）来扩展门户功能
多实例支持：为不同的用户群体创建多个独立的门户实例

定制方式

通过扩展现有模块

查看 iTop 扩展市场，选择适合您需求的扩展模块并按文档安装。

通过编写自定义扩展

要编写自己的门户扩展，需要掌握以下基础知识：

iTop 定制机制 — 了解如何扩展或修改 iTop
逐步示例 — 创建您的第一个扩展
扩展骨架生成工具 — 创建新扩展的骨架和文件结构说明
XML 数据模型参考和 XML 门户参考
iTop 编码规范
FontAwesome v5 图标库

门户定制教程

以下是门户定制的具体教程：

门户定制概述 — 门户定制的整体介绍
门户 XML 参考 — 门户 XML 配置的完整参考
门户限制 — 当前已知的门户限制
门户字段必填 — 在门户中强制字段必填
查看更多或更少的工单 — 修改用户可见的工单范围
为他人创建工单 — 允许为其他用户创建工单
修改范围 — 更改门户中的可见范围
修改 Bootstrap 主题 — 更换门户主题
修改菜单图标 — 修改 Brick 的图标
添加创建按钮 — 添加快捷创建按钮
添加新的浏览模式 — 自定义浏览模式
添加 Dashlet — 在门户中添加 Dashlet
创建新门户 — 从零开始创建新门户
门户上的可选关系 — 动态可选的 n:n 关系

原文：https://www.itophub.io/wiki/page?id=3_2_0:customization:start#customizing_the_portal

Last modified: 2026/06/10 17:31 by127.0.0.1

版本：3_2_0/customization/start.txt · Last modified: 2026/06/10 17:31 by 127.0.0.1

Docs: 修改数据模型

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

本文档介绍如何通过扩展现有扩展或编写自定义扩展来修改 iTop 数据模型。更多详细内容请参考 iTop 官方文档。

概述

iTop 支持通过以下两种方式定制数据模型：

添加现有扩展：浏览已发布的扩展列表，按需安装。
编写自定义扩展：创建 iTop 扩展模块，实现个性化需求。

基础知识

创建 iTop 扩展模块需要了解以下内容：

iTop 定制机制 — 理解如何扩展或修改 iTop
分步示例 — 创建您的第一个扩展
扩展骨架 — 新扩展的结构说明
API 搜索与操作对象
CRUD 事件 — 在对象上添加业务逻辑
事件 API — 添加自定义事件（3.1 新增）
界面 API — 自定义 GUI
XML 数据模型参考与 XML 门户参考
iTop 编码规范
FontAwesome v5 — 图标使用

数据模型修改示例

类、字段与关系

生命周期：状态、转换、秒表

认证与权限

原文：https://www.itophub.io/wiki/page?id=3_2_0:customization:start#changing_the_datamodel

Last modified: 2026/06/10 17:31 by127.0.0.1

版本：3_2_0/customization/start.txt · Last modified: 2026/06/10 17:31 by 127.0.0.1

Docs: 用户界面

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

本文档介绍 iTop 用户界面定制的相关内容。更多详细内容请参考 iTop 官方文档。

概述

iTop 的用户界面定制涵盖多种常见场景，包括字段控制、显示增强、主题颜色、菜单定制等。本文档汇总了各类界面定制的实现方法。

字段控制

强制字段必填：通过多种技术手段强制某个字段必填
强制字段只读：限制特定字段不可编辑
对特定用户隐藏字段：根据用户角色控制字段可见性
表单预填充：自动填充创建表单、搜索表单和转换表单中的字段值
数据完整性检查：在对象保存前验证数据一致性，阻止不合规数据入库
定义废弃规则：设置对象废弃条件
防止重复：通过唯一性规则避免重复数据

显示增强

修改 iTop 首页：将控制台首页重定向到任意 iTop 页面
在弹出菜单中添加条目：通过 iPopupMenuExtension 接口扩展操作菜单
iframe 仪表盘：创建自定义 iframe 仪表盘组件
丰富对象显示：在对象详情页添加自定义标签页或内容
区分同名对象：通过补充属性区分同名对象
修改页面标题：自定义对象详情页的浏览器标签页标题
对象间导航：在对象详情页添加上一个/下一个导航按钮
隐藏影响分析：移除对象详情页中的特定标签页
在列表上添加操作：为对象列表添加批量操作菜单
隐藏对象历史：对特定用户隐藏活动面板中的历史记录
添加对象概览：定义对象摘要卡片，悬停时显示更多信息
排序枚举值：自定义枚举属性的值排序方式
排序转换：自定义生命周期转换按钮的显示顺序

主题与颜色

修改 iTop Logo：替换控制台和登录页面的 Logo
修改颜色等：全面修改 iTop 的颜色方案
高亮关键对象：在列表中突出显示关键对象
高亮状态：为枚举值设置颜色和图标
修改菜单图标：使用 Font Awesome 图标自定义菜单
类颜色与图标：为类设置主色调和图标
修改左侧菜单颜色：自定义左侧导航菜单的颜色
修改主色调：替换 iTop 默认的橙色主色调
创建主题：编写自定义 SCSS 主题

参考

iTop 官方文档

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

Last modified: 2026/06/10 17:31 by127.0.0.1

版本：3_2_0/customization/start.txt · Last modified: 2026/06/10 17:31 by 127.0.0.1

Docs: 自动化与工单管理

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

本文档介绍 iTop 定制中的自动化与工单管理相关场景。更多详细内容请参考 iTop 官方文档。

概述

iTop 定制可通过以下两种方式实现：

安装现有扩展：浏览已发布的扩展列表，选择并安装适合您需求的扩展。
编写自定义扩展：创建您自己的扩展模块，以满足特定的业务需求。

编写扩展的基础知识

创建 iTop 扩展模块需要掌握以下基础知识：

iTop 定制机制 — 了解如何扩展或修改 iTop
分步示例 — 创建您的第一个扩展
扩展骨架生成工具 — 辅助创建新扩展并了解文件结构
API：搜索和操作对象
CRUD 事件 — 在对象上添加业务逻辑
事件 API — 添加自定义事件（3.1 新增）
界面 API — 自定义 GUI
XML 数据模型参考和 XML 门户参考
iTop 编码规范
FontAwesome v5 — 图标使用

“How to” 示例分类

数据模型变更

类、字段与关系

属性用法与约束
向 Server 类添加字段
（重新）定义字典条目
强制字段始终必填
从 Ticket 中移除字段
在 Team 上添加仪表板
创建新的 CI 类：Monitor
定义依赖关系
添加 1:1 关系
n:n 自反与对称关系
对象创建者
合并状态
在 PHP 中添加 TagSet
在 PHP 中添加日志条目
添加 n:n 关系
机密属性

生命周期：状态、转换、计时器

添加状态与转换
统计状态停留时间
状态延迟后通知
计时器行为
为物理设备添加生命周期
按生命周期强制字段必填
在转换时执行动作
转换时可用的预定义方法
允许在非默认状态直接创建
日志更新时重新分配工单
隐藏转换

认证与权限

创建新角色
委派"管理工具"菜单
定义密码策略
实现密码过期
创建自定义认证方法
防止用户意外被禁用

用户界面

必填、隐藏、受控

强制字段必填
设置字段只读
为部分用户隐藏成本
表单预填充
数据完整性检查
定义过时规则
防止重复

显示

更改 iTop 主页
在"其他操作"弹出菜单中添加条目
创建控制台仪表板新 dashlet
丰富对象显示
区分同名对象
更改页面标题
对象间导航
隐藏对象标签页
在列表上添加操作
隐藏对象历史
添加对象概览
排序枚举值
排序转换
计算对象图标

主题与颜色

更改 iTop 标志
更改颜色及其他
高亮关键对象
高亮状态
更改菜单图标
类颜色与图标
更改左侧菜单颜色
更改主色调
创建新主题

自动化

使用对象复制器复制 linkedset
计算工单结束日期
统计工单重开次数
1:n 计算字段
n:n 计算字段
存储 n:n 关系计数
从外部应用同步数据
将工单传输到另一个 iTop
存储 1:n 关系计数
添加附件时添加日志条目
计算 linkedset 依赖值

工单管理

统计等待第三方的时间
考虑覆盖窗口的解决延迟
统计用户请求重开次数 / 停用计数器历史追踪
延迟后自动关闭
计划日期的 TTO 开始
计划用户请求（高级）
按服务子目录的 SLA
从父组织继承服务
按国家使用假期日历进行 SLA 计算
级联变更关闭
服务提供商与中介
日志更新时重新分配工单
停用计数器历史追踪

门户定制

门户定制概览
门户 XML 参考
门户限制
门户 “How to” 示例

贡献翻译

如何翻译

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

Last modified: 2026/06/10 17:31 by127.0.0.1

版本：3_2_0/customization/start.txt · Last modified: 2026/06/10 17:31 by 127.0.0.1