iTopCN – 最终用户手册

Docs: 连接到iTop

Wed, 09 Nov 2022 00:00:00 +0000

登录界面

iTop 的首界面是登录界面——“欢迎使用 iTop!”。每个 iTop 用户必须通过认证后，才能访问应用程序。

输入管理员给定的 用户名 和密码，并且点击 登录iTop。

用户名通常是忽略大小写的，但是密码必须按照管理员给定的密码准确输入。

首次连接到iTop

首次连接到 iTop，将显示下方的欢迎对话框：

跳过对话框并且下次连接到 iTop 时直接进入应用的主界面的话，勾选掉 在启动时显示此消息，点击确定按钮关闭对话框。

→下一篇：主界面

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

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

Docs: 主界面

Wed, 09 Nov 2022 00:00:00 +0000

下图显示了应用程序的主界面，它包含了iTop界面的所有标准元素：

用户菜单

在页面的左下方，通过点击用户图标可以访问弹出式菜单：

它显示关联的个人和连接用户的登录账号
如果用户是应用程序的管理员，也展示在该行中。

弹出式菜单提供了操作。点击它们将加载对应菜单项的操作。

标准门户 如果用户允许从这个控制台切换到门户，能看到提供的这个菜单。如果iTop安装了其他的门户，并且对于当前用户可用，它们也将同时显示在这里。
首选项 帮助用户管理在应用的首选项（语言、显示设置、快捷方式、关心的组织，等等）。
注销终止iTop会话。
修改密码 变更iTop密码。
帮助转向到iTop在线WIKI，仅在iTop Hub有效（假设用户可以访问互联网）。
关于iTop 显示iTop的安装版本。
如果iTop安装了其他的门户，并且对于当前用户可用，它们也将同时显示在这里。

标准门户

如何使用iTop用户门户，请查看《门户用户指南》，这是另一个iTop界面，它是简化的，目标是作为自服务门户提供给客户和最终用户使用。

用户首选项

查看下一章：管理首选项

退出iTop

选择菜单
然后有一条确认消息，允许你重新连接

修改密码

点击 修改密码 菜单选项，显示修改密码窗口：

在 旧密码 输入框输入旧密码。
下一步，在下面的 新密码 输入框，输入新密码。
- iTop管理员可以定义密码复杂度规则，
- 默认要多于8个字符，至少包含一个数字、一个大写字母、一个小写字母和一个特殊字符。
- 复杂度规则仅仅检查新密码，所以旧密码可能并不满足规则。
在第三个输入框重复输入新密码。
当完成后，点击 修改密码 确认修改。

当使用外部机制进行iTop身份验证（如LDAP、Active Directory或单点登录身份验证）时，更改密码 菜单项不会显示。这种情况下，应该使用通常管理密码的方法。

关于 iTop

显示了正在使用的iTop版本

菜单栏

在屏幕左侧，一个可扩展栏包含应用程序的菜单。这是大多数iTop功能的入口点。

菜单组包括图标，可以缩小到只显示图标，从而为有价值的信息腾出空间。

欢迎页

快速回到iTop首页的方法！

在logo上点击将带你返回到iTop首页，默认回到欢迎面板！

展开 & 折叠

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

打开一个菜单组

当单击菜单组图标或标题时，会打开二级菜单栏，包含该组的所有子菜单。对于预定义查询类型的子菜单，则显示查询返回的对象数量：

当结果低于100时，显示准确的对象数量，
否则显示 99+，指示大于99，但考虑到性能原因，不执行确切的统计。

在菜单中搜索

也许你知道一个特定的子菜单标题，但你不记得它位于哪个图标/主菜单下。

点击任意菜单组，并且查看刚出现的列的顶部的灰色过滤区域
然后输入一些字符来过滤包含该字符串的菜单
输入空格，则显示所有菜单
选择菜单过滤列表中，你想要的那个

仅仅使用键盘实现这个功能的一个快捷方式是：

在Chrome中，按下 Alt+M 在菜单中搜索，并不需要鼠标（可以在用户首选项设置中更改这个快捷键，比如它会与Firefox快捷键冲突。）
输入要搜索菜单名称中的部分内容

组织

iTop中管理的许多对象都属于组织。组织是iTop中编排对象的主要手段。例如，访问控制是基于组织的：一个给定的用户可能只被允许访问一组给定的组织。此外，菜单顶部的 组织选择 菜单允许最终用户将当前显示限制在给定组织的上下文中。一旦选择了一个组织，这个"上下文"信息就会在页面间传递。要重置上下文并再次显示所有iTop对象，只需在下拉列表中选择"所有组织"。

如果可能存在的所有组织列表太长（超过50个），则下拉列表将被 自动补全 控件替换。在这种情况下，只需输入组织名称的至少三个字母即可选择。如果不确定名称，请使用 放大镜 图标搜索组织。

根据在iTop中的访问权限，可能无法访问某些组织。在这种情况下，下拉框中没有列出禁用组织，也不能访问属于这些组织的对象。

有时需要缩短下拉框中显示的组织列表。例如，可能需要只查看感兴趣的客户。请参考首选项设置了解关于如何配置列表的更多信息。

连接到iTop ← 上一篇 | 下一篇 → 首选项设置

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

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

Docs: 管理首选项

Wed, 09 Nov 2022 00:00:00 +0000

首选项菜单 允许每个用户去配置：

用户界面 选项，诸如语言、显示选项…
关注的组织列表 显示在 上下文 菜单中
我的快捷方式 由用户创建
应用程序键盘快捷键

本页面中的所有的设置管理仅仅对当前用户生效。

用户界面 包含了多个简单的设置：

语言

允许你改变iTop的语言，

为此，从下拉列表中选择所需的语言，并单击应用按钮。
所选语言用于翻译字段标签、菜单和提示消息。
它不翻译存储在iTop的数据。

列表

默认长度 用于限制每页显示的对象数量，例如在执行搜索时。

如果列表中的元素数量超过这个值，iTop将只显示对象的一个子集，其余的将通过分页系统显示。
每个页面默认配置显示 默认长度 数量的对象。
每页显示更多的对象可能更方便，但会减慢显示速度。
模板（dashlet）中保存的列表可以有自己的"长度"，独立于默认值，参见管理列表。
此长度也用于限制CSV导入的历史（截断视图）。

修改这个默认值，变更数字然后点击应用按钮。

该值是默认值，适用于没有特定配置的所有列表。（参见管理列表了解如何配置特定列表）。

标签栏

这两个参数：布局和导航控制对象的显示方式

布局定义对象的标签标题显示的位置：如之前一样的 水平 和对象显示左侧的 垂直 。
导航定义如何从一个选项卡切换到另一个选项卡：经典 和以前一样，一次只显示一个选项卡，可滚动 所有选项卡都显示在同一页面，可以用鼠标滚动它们。可滚动模式不显示标签，这是耗时的，但只是一个图像，需要点击它来获得内容。

这些模式应用于iTop的所有对象上，同样编辑模式也是一样的。

富文本编辑器

此选项允许选择在每次编辑HTML字段时，工具栏是打开的。

活动面板

此选项指定在对象的详细信息中显示工单日志的方法

一般而言是工单，但它适用于所有至少有一个工单日志的对象

这两个可能的模式是：

你能够添加一个记录，但是首先点击这个图标！
可以直接在工单日志中输入内容并发送（默认记录模式是打开的）。

其他设置

选项 显示废弃的数据 默认不勾选，允许在下拉列表和搜索结果中显示废弃的对象

快速访问

在大型公司中，并不是所有的用户都对记录在iTop中的所有组织感兴趣，例如，如果一个给定的用户只为一组给定的客户工作。这个设置让每个用户都可以定制出现在iTop页面左上角上下文菜单中的组织列表，以简化应用程序中的导航。

快捷方式

使用此选项可重命名或删除用户创建的快捷方式。

参见用户快捷方式了解如何创建快捷方式。
快捷方式会直接显示在欢迎菜单下面的主菜单中。
要重命名快捷方式，请选中名称前的复选框，然后单击 重命名 。
要删除快捷方式，请选中名称前的复选框，然后单击删除（弹出确认消息）。

键盘快捷键

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

设置的默认快捷键可能与您的浏览器、操作系统的快捷键冲突，可以更改它们。
1. 点击钢笔图标，
2. 然后按下想要在键盘上设置的快捷键，就完成了。
3. 结果显示为按下的键，作为更改的反馈确认。
4. 如果你改变了主意，从第一步开始。

你可以在互联网上查看现有的最流行的web应用程序的快捷方式。

用户的默认头像

可以用来关联一个头像到您的用户。

如果你的联系人有照片，那么就会使用它。

主界面 ← 上一篇 | 下一篇 → 对象显示和修改

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

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

Docs: 对象显示和修改

Wed, 09 Nov 2022 00:00:00 +0000

显示

在iTop中总是以相同的方式显示一个对象的详细信息，如下图：

标头

标头部分包含了多个关键信息：

对象的 友好名称（friendly name），可以是单个对象字段，如名称（name）或者对象字段的组合，如人员的名字 + 姓氏。
对象所属类。
如果该对象所属类定义了伴随状态的特定颜色，那么对象 状态（status） 则会显示。
每一类对象都有自己的边框颜色，在任何时候都更清楚所在的位置。
一个可选的对象图标，对应显示的实例，或者通用于类的所有对象。

操作

对象允许的操作列在右上角。常用的操作显示为图标。

编辑图标允许修改当前对象。如果不允许编辑当前对象，则不可用。
创建图标允许创建与当前对象属于同一类的对象。如果不允许创建当前类的对象，则不可用。
刷新图标允许刷新当前对象的显示，以防它在显示后被修改。
搜索图标允许搜索当前类的对象。
其他操作图标允许列出可以对应于对象的其他操作：

在这个示例中，在人员的详情中Create a user request… 操作，是由扩展 User action Configurator 提供的功能。
转换（transitions）操作在转换图标下分组。

当向下滚动时，头部会缩小但在顶部仍然可见，因此始终可以访问这些操作。

选项卡

属性选项卡显示对象的实际属性。
根据所显示对象的类别（例如工单），可能会有一个额外的通知选项卡可用，显示响应此对象上的事件而发送的所有通知。
其他选项卡显示所选对象与数据库中其他对象之间的关系。
例如，团队选项卡显示所选人员所属的所有团队。工单选项卡显示所选人员作为 请求者 的工单。
如果没有足够的空间来显示所有选项卡，则可以在位于选项卡行末尾的其他选项卡图标下方访问其余选项卡。

有两种显示对象内容的方式，用户可以根据偏好进行选择。此导航设置适用于处于读取和编辑模式下所有的iTop对象。

经典：

一次只显示一个选项卡。
单击一个选项卡标题，可切换到另一个选项卡。

滚动：

所有选项卡都显示在同一页面中。
可以用鼠标滚动浏览，或单击选项卡标题。

对象修改

要修改对象，请从对象的详细信息中单击编辑图标操作（在只包含一个对象的列表中也可以使用相同的操作）。

用来修改对象的表单与对象的详情页非常相似。唯一的区别是这些字段是可编辑的。例如，修改人员的表单如下所示：

对于某些字段，值不是自由文本，而是必须要从下拉列表中选择：

树形按钮 用来组织层次结构的值。

加号按钮 是创建对象并将其添加到列表的快捷方式。该按钮仅对允许创建此类型对象的用户可用。例如，在创建或修改工单时，单击 发起人 字段的加号按钮。此时，显示的表单允许去创建一个新的人员：

当必填字段为空时，或者当字段不遵循字段的预期格式（例如电子邮件地址）时，将出现红色消息。只有在正确填充所有字段时，才能保存对象的修改（使用应用按钮）。

当一个给定字段的可能值的数量超过了一个配置值（默认为50），下拉列表将被一个 自动填充 字段所取代，如下所示：

输入至少 三个字母 以触发搜索，并从与输入字母匹配的对象列表中选择，或使用放大镜按钮打开一个查询对话框：

查询对话框列出了所有的对象。可以在选择对象之前使用顶部的表单，缩小搜索范围，然后单击确定返回到主表单。

当编辑一个HTML字段时，（工单日志记录是HTML字段），包含一个嵌入式编辑器，查看 CKEditor site 获取更多的信息。

对于文本和html字段，iTop提供了拼写检查，通过使用组合键 CTRL+鼠标右键。

活动面板

工单日志独立编辑

添加了一个新的面板，方便处理人只需要在日志条目中提供回复并可能应用变化的这种非常常见的情况。

为此，无需修改工单，可以直接输入回复并发送，同时如果需要，只需单击一次即可申请变化。
这个新选项只存在于控制台中，对于所有有工单日志的对象。
对于有多个工单日志的对象，如果修改了多个工单日志，则要求确认。

历史记录过滤

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

可以过滤这个面板，去查看：
- 日志记录，你能够更好地过滤，去仅仅查看评论或私信
- 状态变化 无论何时对象的状态变化
- 编辑当对象已创建或修改过时（也包括发送的通知）
在记录的旁边，显示用户照片（如果他们有照片的话），否则显示的是他们的姓名首字母。

历史记录的时间戳是 相对最近时间，例如：3天前，当超过一周的时间则是 绝对时间，除非在你的 iTop 中是不同的配置。

提及用户

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

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

展开 & 折叠

活动面板能够展开或者折叠，取决于办理人工作时是否需要读取和编辑工单日志或者是否需要修改工单本身。

并发访问

如果激活了 concurrent_lock_enabled 参数，阻止多个用户同时修改同一个对象，那么这个主题才适用。

如果用户输入一些文本，或者只是尝试在当前版本下的对象的活动面板中编辑工单日志，或者只是由另一个用户在工单日志版本下编辑案例，那么这个用户将收到一条简短的消息，让他知道只有在其他用户完成后他才能提交他的记录。注意，对于这个用户，发送 按钮是灰色的。
iTop将每隔 activity_panel.lock_watcher_period 秒进行检查，是否锁定已释放，如果已释放，它将再次锁定，但这次是针对这个用户，并且会激活 发送 按钮，而不会丢失已经在工单日志中输入的文本。

处理工单附件

附件模块允许将文档（任何文件或图像）上传到iTop，并将其"附加"到iTop中的给定对象。这与电子邮件附件非常相似。

附件与它们所附加的对象相关，当该对象从iTop中删除时，附件也将被删除。如果想将文件上传到iTop，并将它们"附加"到iTop中的对象上，那么可以考虑创建"文档"对象。参考文件文档。

当创建或修改一个工单时，管理工单的附件，点击附件标签页：

要上传一个新的附件，单击 选择文件 按钮并选择所需的文件。注意，单个上传文件的最大大小显示在 选择文件 按钮旁边。如果文件大于该值，则无法上传至iTop。这个最大大小取决于服务器上的几个设置，只能由管理员更改。

附件一旦上传，它们就会列在选项卡中，每个文件都有一个图标。附件的名称是下载的超链接。

使用在行末的回收站图标去删除一个附件。附件仅仅从当前对象（这里是一个工单）做了移除，但是从iTop中已完全删除。

当附件为图像时，当鼠标移动到附件图标上时，就会预览显示。

对工单的修改（增加或者移除附件）实际上是点击应用按钮时执行的。对于工单表单，点击取消则会取消对于附件的任何修改。

拖拽

还可以通过直接在浏览器窗口上拖拽要附加的文件来添加附件。当文件被拖到"附件"选项卡上时，通常显示附件文件的区域周围会出现一个蓝色阴影：

如果拖动时"附件"选项卡不是活动选项卡，则仍然可以将文件附加到工单上，并且在拖动操作时选项卡本身显示为蓝色阴影：

管理对象关系

在iTop中，显示在对象详细信息上的大多数选项卡表示了与对象之间的关系。所有这些关系都以相同的方式进行管理。

但有两种类型的关系，它们在后台的处理方式略有不同：

多个，例如"团队-个人"关系：在这种关系中，一个团队通常包含多个人员，一个人员可以属于多个团队
一个简单的关系，例如"经理-个人"关系：在这种关系中，经理可以管理多个人员，但一个人员永远不会超过一个经理

多个关系

一个"团队"的成员的修改表单类似这样：

变更

要用另一个成员更改一个团队成员，只需编辑要删除的成员的名称，并将其替换为要添加的成员的名称。

增加

为了添加一个成员到团队：

点击在底部的"添加个人对象…" 按钮。显示将弹出查询表单去选择人员。
检查列表中期望的个人
并且点击"添加"返回主表单。

移除

要从关系中删除对象，请选中表单中的相应行，然后单击底部的"移除对象"按钮。

注意，从关系中删除对象并不实际从iTop中删除这些对象。只删除对象之间的关系。

如果取消当前对象的编辑，将不会保存对关系（添加和删除）的修改。但是如果您使用+图标创建了一个新对象，那么无论您在当前对象版本上做什么，该对象都会创建。

简单关系

在工单上，我们也有类似于"父子"关系，如：经理-个人关系。一个工单可以有 0个或1个 父，而一个父对象可以有0到多个子对象。另一种简单关系是ConnectableCI上的Interfaces子对象，其中每个子对象 必须有一个 父对象，没有它就不能存在。

这样的子对象只能链接到一个父对象，所以如果已经有一个父对象，它将被更改，而不能只是添加。
点击"添加 xxxx" 按钮，显示一个弹出的窗口去查询久远的对象
设置可选的过滤条件
点击刷新按钮刷新列表。
确保在希望添加的行的开头的选择框，进行了选择，
点击"添加"按钮验证你的选择，并且关闭对话框。
选择的对象将被修改，并且将指向当前的对象，该情况将在相应的选项卡中可见。

要从当前工单中移除相关工单，只需选中相应的复选框，然后单击"移除"。

注意，从关系中删除对象并不会从iTop中删除这些对象。只重置对象之间的关系。（在相关的工单上指向当前工单的字段会重置）

首选项设置 ← 上一篇 | 下一篇 → 操作

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

版本：3_2_0/user/display_and_modification.txt · Last modified: 2025/05/13 12:16 by 127.0.0.1

Docs: 操作

Wed, 09 Nov 2022 00:00:00 +0000

在iTop中，操作用于修改对象。操作可以执行：

在对象列表（参考章节管理列表）情况下，所选的操作将应用于列表中的所有对象
在对象的详细页面

操作按钮只显示给有足够权限执行这些操作的用户。

在iTop中的标准操作是这样的：

新建

此操作用于创建与当前显示的对象类型相同的新对象。点击"新建…"，显示对象的创建表单。

默认情况下，该操作总是会显示为图标，因此在下拉菜单中不会出现。

根据上下文，有些字段可能会自动预填充。例如，如果上下文设置为 Demo 组织，当点击新建创建一个新的个人的时候，将显示一个带有组织的表单，预填充为 Demo。

修改

此操作显示要更新对象的表单。创建表单和修改表单两者非常相似，只是在修改对象时，表单中的值会预先填充为当前要修改对象的值。

默认情况下，此操作一直显示为图标，因此不会在下拉菜单中出现。

删除

删除操作通常位于 其他操作 弹出菜单之中。

该操作用于从iTop中永久删除对象。为了保证iTop中数据的一致性和完整性，删除对象也会影响其他对象。根据数据模型中定义的规则，其他对象可能会被自动修改或删除，又或者在手动删除某些依赖对象之前，可能无法删除。

在任何情况下，都会显示一个列出所有受影响对象的确认界面。

以删除整个组织为例，系统显示如下确认界面：

在这种情况下，iTop发现有几个人属于本组织。由于数据模型的定义要求个人必须属于一个组织，而且个人的删除不是自动的，因此当存在属于组织的个人时，不能删除组织。同样的逻辑适用于所有必须具有组织的其他对象。

这就是 删除! 按钮变灰的原因。
为了删除组织，必须首先处理所有出错的对象，要么删除它们，要么将它们分配给其他不同的组织。

关系

根据所显示对象的类型，还提供了额外的关系菜单。例如，对于大多数配置项，定义了两类关系：影响和 依赖于 。这种情况下，其他操作 弹出菜单中会有两个额外可用的菜单。

当选择这样的操作时，会显示关系的页面：

您可以使用顶部带有图标的复选框来过滤显示（更新选择后只需点击刷新即可）。
将鼠标移到到对象上以显示附加信息的工具提示（以及指向其详细信息的链接）
在对象上单击并拖动，可重新排列图表
点击并拖动背景可以移动整个图表
+ 和 - 按钮，以及图表右上方的滑块（和鼠标滚轮）用于调整缩放级别
分组阈值 定义了用于创建一个组的相似对象（相同类型，相同状态）的最小数量，以取代图表中的单个对象，简化图表。更改此值时，单击刷新将以新的分组级别重新计算图表

通过右键单击图表中的对象，可以从弹出菜单中选择详情返回其详细信息。对于对象的组，详情菜单 显示该组中的元素列表。

上下文

其他信息 下拉列表定义了在计算和显示图表时对于工单（更新选择后只需按刷新）的考虑。
当图表中的对象链接到（至少）一个 上下文 工单时，在对象图标旁边会显示一个表示工单类型（事件、变更）的小图标。链接到给定对象的工单列表可在该对象的工具提示中找到。
打开的变更 上下文对应"变更"，这些变更既没有关闭也没有被拒绝，正在产生停机并影响一些显示的配置项（Impact != ‘不受影响’）
最近的变更（72h） 上下文对应"在不到3天内关闭的变更，已经产生了停机，并且确实影响了显示的一些配置项。
打开的事件 上下文与事件相对应，这些事件既没有关闭也没有解决，并且确实影响了显示的一些配置项。

将图表导出为PDF文档

要将图表导出为PDF文档，请使用图表右上方的工具菜单：

将显示如下对话框：

导出生成了一个可打印的PDF文档，其中第一页包含图表（显示在屏幕上），左侧是图例，底部有一个可选的备注区域。对象列表作为一组表（每个对象类别一个表）添加到其他页面上。

有以下选项：

页面格式: PDF文件的尺寸：A3、A4或Letter。
页面方向: 横向（横向）或纵向（纵向）
标题: 文档的标题，作为标题添加到每页的顶部
备注: 在文档的第一页，图表下方，将被整合的自由文本区域（如果不是空的）。
包含的对象列表: 如果选中，图表中的对象列表将作为一个大表格添加到PDF文档中作为附加的页面。

当勾选了 包含的对象列表 并且要导出的对象列表很大时，PDF文档的创建可能会非常慢（> 100 对象）。

邮件

邮件的操作位于 其他操作 弹出菜单中。

该操作将创建一个新的eMail消息，其中包含iTop中所选对象的链接。电子邮件是由最终用户计算机上配置的客户端邮件程序创建和发送的。

消息的接收者将收到一个URL链接，以导航到对象的详细信息，但她/他必须有一个iTop帐户才能查看信息，因为将提示她/他进行身份验证才能查看页面。

CSV 导出

一个对象的CSV导出类似于列表的CSV导出，除非结果导出中只有一行数据。

Excel 导出

导出一个对象的Excel类似于列表的Excel导出，除非结果导出中只有一行数据。

打印友好版本

此操作在浏览器的另一个选项卡中打开当前对象的 打印友好 版本的详细信息。这个版本的详情为打印进行了优化：所有的选项卡都作为页面内部分列出，大部分周围的元素（菜单，搜索栏）被删除。

此外，该页面还可以在打印之前通过隐藏/显示部分内容来配置，只需单击眼睛图标即可。

要打印页面，可以使用位于页面顶部的打印按钮，但也可以在打印之前通过使用从 浏览器菜单 访问 打印预览 来获得所见即所得的预览。

页面顶部的横幅在打印输出中不可见。

工单变化

在iTop中管理的一些对象遵循特定的生命周期，这些生命周期对应于特定的流程。例如，对于iTop中管理的不同工单（事件工单、变更管理工单等），情况就是如此。对于这些对象，可以使用其他操作，对应于流程执行工作流。生命周期操作可以在变化弹出式菜单中作为附加的菜单项使用：

或者直接在对象的修改表单中作为附加的按钮：

在后一种情况下，单击 等待批准 按钮严格意义上等同于单击应用以保存对象的当前修改，然后从 其他操作 下拉菜单中选择 等待批准。每个对象上可用的操作取决于：

对象的生命周期（每种类型的对象可能有不同的生命周期）
对象的当前状态（并非所有状态下都可以执行所有操作）。
由她/他的角色定义的用户权限：某些操作仅限于特定的角色。

对象特定的操作

扩展可以为特定对象带来特定的操作。

以下是由用户操作配置器扩展的示例：

对象显示和修改 ← 上一篇 | 下一篇 → 搜索

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

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

Docs: 搜索

Wed, 09 Nov 2022 00:00:00 +0000

在iTop中，大多数对象的详细信息中都可以看到搜索图标，单击此图标会切换到多条件搜索表单。搜索表单中的所有条件都会使用 AND 操作符 进行组合。这意味着在搜索工单时，如果指定 Claude Monet 为发起人以及一组状态，搜索结果将列出所有符合这些条件的工单。

你可能 找不到 想要找的对象，原因可能有很多：

由于您的用户权限，您不允许查看它，
在左上角的下拉列表中选择了一个组织，该对象不属于该组织。
对象是废弃的，首选项 中没有选择 显示废弃的数据

场景

添加条件

大多数搜索都有预定义的搜索条件，但你可能想要更改它们或添加新的搜索条件：

打开 添加条件 框
可以通过输入属性的开头内容来过滤列表
可以点击一个属性名，会将其添加为过滤条件并关闭该框
或者，可以点击复选框，它将选中该属性但保持弹出框打开以选择更多条件，在这种情况下，下一步点击名称就能够选中。

设定标准

打开一个条件框。建议选项将取决于属性的类型。
选择一个选项：
- 在文本框中输入数据，
- 选择单选按钮
- 检查一个或多个选项
如果你想要更多的选项，点击"更多"
一旦你设置了你的选项，点击按钮
- 搜索：执行搜索
- 应用：保存你的条件选项（此选项仅在因性能原因停用"auto-submit"时可用）
- 取消：取消选项和选择条目
- 在屏幕上的任何地方执行默认操作 搜索 或 应用

删除条件

您可以通过单击红色的x图标来删除条件。请注意，这种删除通常会自动刷新列表。默认情况下，条件带有 任何，这意味着它不会对结果进行过滤，因此删除它对结果列表没有影响。

保存搜索

你可以在结果列表上使用 创建快捷方式… 操作来保存搜索结果：

这会创建一个快捷方式，当后续打开它时，所有 设置的 条件都会在那里。
带有 任何 的条件不会存储，因此会丢失，但这并不会改变搜索结果。

重新搜索

可以使用搜索按钮再次强制执行搜索。

一般来说，它是无用的，因为对条件的任何更改或删除条件都会刷新列表，但如果在执行搜索后创建或修改了与条件匹配的另一个对象，则刷新是有用的。另一种需要它的情况是，由于性能问题，对于这个特定类的搜索不是自动的。

搜索功能

这里列出了每种属性类型的详细搜索功能。

文本

这适用于简单的文本、html和工单日志。

如果出于性能考虑，在字段上声明了一个索引，那么默认操作符不是 包含 而是等于。工单的编号字段就是这样的。

你甚至可以使用正则表达式（regex）

% 是一个映射任意字符串的 特殊字符，因此可以搜索：

php%syntax 可以搜索在 php 和 syntax 包含任意内容的这个顺序的内容

要搜索确切的字符 %，需要输入 %（反斜杠）

数字

你可以根据数字进行过滤：大于、小于、之间，…

选择列表

它提供了可用值的完整列表，你可以选择它们：全部、无、一个或多个。

对象

根据对象的数量，它将提出完整的对象列表或自动完成模式来检索您需要的对象。你可以选择预留的那些，同时搜索其他的。

可以合并确切的值和 未定义 的值（未定义的值代表着未记录，在OQL中=0）。

层次结构

有时对象以层次结构组织。这是iTop标准数据模型中组织对象的情况。当尝试在此字段上进行过滤时，它看起来像一个普通对象，但在其后台行为方面，它与搜索属于 IT部门的人员时完全不同，它会递归解析组织树形结构，搜索属于任何 IT部门 子组织 的人员：

IT Department
- IT Special
  - Software Service
  - Service n°2
- Division B
  - Service n°3

日期

iTop默认使用以下格式来表示日期和时间：

日期：首先年显示为4位数字，接着是一个破折号，后跟用2位数字表示的月，然后是一个破折号，最后是用2位数字表示的日。（简而言之：YYYY-MM-DD）
日期和时间：以上述格式开始一个日期，接着是一个空格，然后用2位数字表示的小时（24小时制）后跟一个冒号(:)，然后是用2位数字表示的分钟后跟一个冒号(:)，最后是用2位数字表示的秒。（简而言之：YYYY-MM-DD hh:mm:ss）

您的管理员可以定义其他格式，这可能取决于您的语言。

全局搜索

全局搜索 功能位于所有iTop页面的左上角。

全局搜索在iTop的所有对象中搜索给定的文本字符串。要启动搜索，请 输入要搜索的文本 并单击 放大镜图标 或按下键盘的回车键。

搜索结果按组显示：所有匹配的同类对象被分组在一个表中。

由于全局搜索搜索iTop数据库中的所有对象，因此当对象数量增加时，它可能变得相当慢。但是，您可以通过将其范围限制为特定类别的对象来加快搜索速度。指定全局搜索范围的语法如下：class_name: text_to_search。

搜索 Server:webserv 将在所有服务器对象中搜索包含文本"webserv"的任何字段。

为了限制范围，您还可以将X指定为包含子类的类。例如：

搜索 Contact:dali 将搜索包含 dali 的所有团队和人员的任何字段。

全局搜索是不区分大小写的。搜索 Dali、dali 或者 DALI 将给出相同的结果。

对象显示和修改 ← 上一篇 | 下一篇 → 管理列表

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

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

Docs: 管理列表

Sat, 26 Aug 2023 00:00:00 +0000

在iTop中，列表是相当常见的。在菜单项中，可以发现有些指向列表的菜单项，也可以在搜索结果和全局搜索中找到列表。一旦显示了一组对象的列表，其所执行的操作始终是相同的。

例如，下面是一个用户请求（User Request）的列表：

如果一个列表包含的元素超过某个数量（可配置），则会显示为分页列表：

导出操作仅适用于终端用户的角色中包含 BULK_READ 权限的用户。

Toolkit菜单

在 iTop 中显示对象列表时，列表本身（而无需通过修改 iTop 中的对象）可以执行一些操作。这些操作通过位于列表右上方的toolkit弹出菜单执行。

配置列表

第一个可能的操作是配置列表的外观。您可以选择：

显示哪些列以及显示顺序
列表如何排序
同时显示多少项（参见上面的分页列表）
此配置将应用于哪个列表：（仅适用于此特定列表，还是适用于所有尚未具有特定配置的列表）。

所有这些配置都是通过弹出对话框完成的：

高级用法：

如果列表显示多个对象类（例如，SELECT a,b FROM Person AS a JOIN UserRequest AS b…），那么不能将配置保存为 仅这个列表，
如果将其保存为 默认所有列表，它仅会影响选择了 完全相同 的类且具有相同别名的列表，例如，如果另一个列表基于该查询（SELECT a2,b FROM Person AS a2 JOIN UserRequest AS b…），则上述保存将不适用，因为存在一个不相同的别名。

邮件

此操作类似于对象详细信息中的邮件操作，唯一的不同在于插入到消息中的超链接指向指定的对象列表。

CSV 导出

CSV 导出操作会显示一个配置对话框，允许您：

选择格式选项：CSV 的分隔符字符（逗号、分号、制表符或其他字符）
指定 文本限定字符 字符（用于围绕 CSV 内的文本字符串）
选择字符编码
对于枚举字段（例如状态），选择值是要本地化（即使用屏幕上显示的值）还是使用内部（与语言无关的）代码。
选择包含在导出中的字段
排列列的顺序

要排列列的顺序，请在对话框底部显示的 列顺序 部分中的表中拖放列。要拖动列，请单击列的标头。

配置好导出后，点击导出来生成它。如果导出包含大量数据（超过 1000 行），将会显示一个进度条。

导出完成后，您可以点击对话框顶部的链接 点击此处下载 ，将结果下载为 .csv 文件，或者从文本区域中复制并粘贴导出的纯文本内容：

如何在 Excel 2007/2010 中粘贴 CSV 数据

如果使用复制/粘贴将 CSV 数据导入 Excel 中，所有数据都将放置在一个列中。幸运的是，这很容易更改。

在 Excel 的数据选项卡中，点击 文本到列 图标：

接下来，会出现以下对话框向导：

选择 分隔符，然后点击 下一步 >。

接下来，在以下屏幕中：

选择逗号，然后点击完成。

在同一会话中（不要关闭和重新启动 Excel），下次复制/粘贴 CSV 数据时，Excel 将自动使用相同的设置执行文本到列的转换。

Excel 导出

从菜单中直接导出到 Excel（XLSX 格式）：

Excel 导出操作会显示一个配置对话框，允许你：

选择包含在导出中的列
排列列的顺序

要排列列的顺序，请在对话框底部显示的 列顺序 部分中的表中拖放列。要拖动列，请单击列的标头。

当点击导出时，Excel 文件将被生成。如果要导出的对象列表很大（> 1000），将显示一个进度条。导出完成后，可以通过点击对话框顶部的链接 点击此处下载 来下载 Excel 文件：

对于大量数据的导出（例如几千个对象），CSV 导出可能比 Excel 导出快得多。

PDF 导出

从 iTop 2.2.0 版本开始，有一个新的菜单项 导出PDF：

此菜单会生成一个 PDF 文档，其中包含一个大的表格，每个对象在列表中占据一行，每个选定字段占据一列。

导出PDF操作会显示一个配置对话框，允许你：

选择用于渲染 PDF 的页面尺寸：A3、A4 或 Letter
选择页面方向：纵向或横向
选择包含在导出中的列
排列列的顺序

要排列列的顺序，请在对话框底部显示的 列顺序 部分中的表中拖放列。要拖动列，请单击列的标头。

PDF 输出以等宽列渲染（即，如果选择了 10 列，则每列将使用页面宽度的 1/10）。当选择的列数相对较少（<10）时，效果较好。如果需要生成包含许多列的 PDF，请使用横向方向。

当点击导出时，PDF 文档将被创建。如果要导出的对象列表很大（> 1000），将显示一个进度条。导出完成后，可以通过点击对话框顶部的链接 点击此处下载 来下载 PDF 文件：

添加到仪表盘

显示为列表的每个结果都可以添加到一个可编辑的仪表盘之中。点击菜单 添加到仪表盘：

然后选择要将列表添加到的仪表盘以及要使用的"仪表盘小部件"类型：

列表可以添加到仪表盘中，作为：

对象普通列表
饼图（通过给定字段对对象进行分组）
柱状图（通过给定字段对对象进行分组）
分组（表），显示按给定字段分组的对象计数

当用户点击确定时，新的仪表盘小部件将添加到所选仪表盘的末尾（在最后一个使用的单元格之后添加一个新单元格）。如果勾选了 编辑仪表板，则修改后的仪表盘会立即在仪表盘编辑器中打开。

有关如何自定义生成的仪表盘的信息，请参阅编辑仪表板。

创建快捷方式

在提示时：

输入新快捷方式的名称
点击确定
新的菜单以此名称将出现在 我的快捷方式 菜单下

刷新间隔 的最小值为 5 秒。

搜索 ← 上一篇 | 下一篇 → 快捷方式

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

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

Docs: 快捷方式

Sat, 26 Aug 2023 00:00:00 +0000

快捷方式用于在 iTop 中导航到特定的对象列表。可以将其视为一种动态书签，因为书签列表是通过其搜索条件来定义的。

快捷方式会显示在 我的快捷方式 菜单下的附加菜单项，位于 iTop 页面左侧的欢迎弹出的资源管理器菜单中。

创建新的快捷方式

要创建新的快捷方式，首先搜索想要加入书签的对象。

例如，假设你想要轻松访问所有标记为"现场联系人"的人员。搜索在其职能中具有 site 关键词的联系人：

然后单击 其他操作 弹出菜单，选择 创建快捷方式：

在提示时，

输入新快捷方式的名称（这是在菜单中显示在 我的快捷方式 下的名称），
如果需要，启用自动刷新（最小允许值：5秒），
然后点击确定。

使用快捷方式

然后，新的快捷方式将添加到菜单中。请注意，快捷方式菜单会立即显示返回的对象数量：

点击快捷方式菜单：

其过滤条件会显示在搜索栏中，以便了解它是如何筛选的，
会显示其标题，以便记住是如何进入该界面并查看显示的内容

管理快捷方式

要重命名或删除快捷方式，请前往用户首选项页面。

管理列表 ← 上一篇 | 下一篇 → 编辑仪表盘

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

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

Docs: 编辑仪表盘

Wed, 09 Nov 2022 00:00:00 +0000

编辑仪表盘

iTop 中的某些页面是 仪表盘。仪表盘用于在同一页上显示有关不同 iTop 对象的信息。大多数概览页面以及欢迎页面都是仪表盘。在 iTop 2.0 中，每个用户都可以通过编辑现有的仪表盘页面来定制自己的仪表盘，但是不能够创建新的仪表盘页面。

当页面是可编辑的仪表盘时，在页面右上角会出现小的 3个点菜单，显示一个下拉菜单项来创建自定义版本。

要编辑当前页面，请选择 新建自定义版本。

几秒钟后，一个弹出对话框会出现，其中包含 仪表盘编辑器 对话框：

仪表盘由名为组件的构建块组成。

仪表盘本身排列了包含组件的显示。仪表盘仅具有三个属性：

布局（一列、两列或三列）
可选标题
自动刷新设置（禁用，或以秒为单位的刷新间隔）

布局确定如何在页面上排列组件：它确定了一个网格，每个组件都分配给网格的一个单元格。当布局更改时，单元格（以及单元格内的组件）将重新组织以产生所需的显示。

要编辑组件的属性，请在对话框的左侧单击它。选择的组件周围会出现橙色边框，并且组件的属性将显示在对话框的右侧。要修改组件的外观，只需在右侧修改属性。组件将根据你的修改而改变。要从仪表盘中删除所选的组件，请单击所选组件右上角的 红色叉。

要将新的组件添加到仪表盘中，请将其中一个组件图标拖动到仪表盘的所需区域，然后在右侧调整属性以完成仪表盘。

你还可以从任何 iTop 对象列表创建新的组件。有关如何执行此操作的更多信息，请参见管理列表。

在编辑完成后，点击保存，保存修改并返回 iTop 页面。

要撤消自从点击 编辑此页面 以来所做的所有修改，请点击取消。

仪表盘的修改适用于当前用户。所有其他用户会保留自己的仪表盘副本（或默认仪表盘，如果他们未自定义它的话）

组件（Dashlet）类型

以下是用于构建 iTop 仪表盘的不同类型的组件：

图标	名称	描述
文本	文本	一个自由文本区域。用于在页面上添加标题或内容。
列表	对象列表	以表格形式显示 iTop 对象的列表，类似于任何搜索结果。
饼图	饼图	iTop 对象的列表，根据给定字段分组并显示为饼图。2.5 版本新增：除计数外，还可以在指定字段上使用各种功能（求和、平均、最小和最大值）。还可以指定排序方向和最大结果数。
柱状图	柱状图	iTop 对象的列表，根据给定字段分组并显示为柱状图。2.5 版本新增：除计数外，还可以在指定字段上使用各种功能（求和、平均、最小和最大值）。还可以指定排序方向和最大结果数。
分组（表）	分组（表）	iTop 对象的列表，根据给定字段分组并显示为表格。2.5 版本新增：除计数外，还可以在指定字段上使用各种功能（求和、平均、最小和最大值）。还可以指定排序方向和最大结果数。
标头	标头	左侧带有图标和标题的灰色横栏。
带计数的标头	带计数的标头	左侧带有图标、标头和一个表格的灰色横栏，显示按给定字段分组的对象计数。
徽章	徽章	带有文本的图标，显示给定类别的对象总数，并提供两个链接：“创建…” 和 “搜索…"。

动态组件

大多数组件在其属性中都包含了一个 OQL（对象查询语言）。这些 OQL 可以根据当前用户、当前时间以及当前对象（如果存在）进行调整，实现动态效果。

如果仪表盘是一个 菜单 仪表盘，您可以使用前两种方法。

基于当前用户

:current_contact_id：这是与连接用户关联的联系人的 ID，如果用户未关联联系人，则为 0。它允许显示当前用户是处理人的工单，例如：

SELECT Ticket WHERE agent_id = :current_contact_id

基于时间

在下面的 OQL 示例中，我们显示过去 30 天内创建且尚未关闭的工单：

SELECT Ticket
WHERE creation_date > DATE_FORMAT(DATE_SUB(NOW(), INTERVAL 30 DAY),'%Y-%m-%d 00:00:00')
AND STATUS != 'closed'

基于当前对象

仅适用于在对象上定义的仪表板属性，您可以使用当前对象的任何字段来过滤您的 OQL。

例如，在组织（Organization）上，您可以使用占位符 :this->att_code，其中 att_code 可以是组织的任何字段，包括 id。

SELECT UserRequest WHERE org_id=:this->id

编辑自定义版本

一旦创建了特定仪表盘的自定义版本，只能编辑自定义版本。

在不同版本之间切换

在浏览仪表盘时，你可以随时在自定义版本和标准版本之间切换显示。

橙色建筑图标表示处于 标准版本：
橙色人物图标表示正在查看 自定义版本：

导出仪表盘

仪表盘定义可以导出为XML文件，用于存档或与其他用户共享。
要导出仪表板，请点击菜单项 导出到文件…。
在提示时，输入下载位置（导出的仪表盘将保存到计算机上的位置）。

导入仪表盘

要从XML文件导入仪表盘定义，请点击 从文件导入…，然后从计算机上选择要上传的XML文件。

如果在尚未自定义的仪表板菜单上导入仪表板，系统将自动创建一个自定义版本。

当在已存在自定义版本的情况下导入仪表板时，该自定义版本将会丢失。如果想要保留该版本，请先导出它。

打印仪表板

可以选择纸张方向，然后使用浏览器的打印菜单：

放弃定制内容

随时可以放弃仪表盘的定制内容。只需点击 删除自定义版本…，然后在弹出的确认对话框进行确认。

高级自定义

拆分单元格

有时手动重新组织仪表盘会有些困难，特别是当在一个单元格中有许多仪表盘并且想要将它们拆分成多个单元格时。

在仪表盘上，选择操作 导出到文件… 并将文件保存到您的计算机上
使用 XML 编辑器进行编辑，输入下面的代码片段，其中想要拆分单元格的位置
- 每次粘贴代码时，将 X 替换为一个唯一的数字，以标识仪表盘中新单元格的顺序
保存文件
在你的 iTop 仪表盘上选择操作 从文件导入… 并上传保存的 XML 文件

 </dashlets>
 </cell>
 <cell id="X">
 <rank>X</rank>
 <dashlets>

描述仪表盘的一个XML文件样例：

<?xml version="1.0"?>
<dashboard xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <layout>DashboardLayoutOneCol</layout>
 <title>Menu:WelcomeMenuPage</title>
 <auto_reload>
 <enabled>false</enabled>
 <interval>300</interval>
 </auto_reload>
 <cells>
 <cell id="0">
 <rank>0</rank>
 <dashlets>
 <dashlet id="1" xsi:type="DashletHeaderStatic">
 <rank>0</rank>
 <title>Menu:ConfigManagementCI</title>
 <icon>../images/icons/icons8-database.svg</icon>
 </dashlet>
 <dashlet id="2" xsi:type="DashletBadge">
 <rank>1</rank>
 <class>BusinessProcess</class>
 </dashlet>
 <dashlet id="3" xsi:type="DashletBadge">
 <rank>2</rank>
 <class>ApplicationSolution</class>
 </dashlet>
 <dashlet id="4" xsi:type="DashletBadge">
 <rank>3</rank>
 <class>Contact</class>
 </dashlet>
 <dashlet id="5" xsi:type="DashletBadge">
 <rank>4</rank>
 <class>Location</class>
 </dashlet>
 <dashlet id="7" xsi:type="DashletBadge">
 <rank>5</rank>
 <class>Server</class>
 </dashlet>
 <dashlet id="8" xsi:type="DashletBadge">
 <rank>6</rank>
 <class>NetworkDevice</class>
 </dashlet>
<!-- You want to split here -->
 <dashlet id="11" xsi:type="DashletHeaderDynamic">
 <rank>0</rank>
 <title>Menu:RequestManagement</title>
 <icon>itop-welcome-itil/images/user-request-deadline.svg</icon>
 <subtitle>Menu:UserRequest:OpenRequests</subtitle>
 <query>SELECT UserRequest WHERE status != "closed"</query>
 <group_by>status</group_by>
 <values>new,assigned,escalated_tto,escalated_ttr,resolved</values>
 </dashlet>
 <dashlet id="12" xsi:type="DashletObjectList">
 <rank>1</rank>
 <title>UI:WelcomeMenu:MyCalls</title>
 <query>SELECT UserRequest AS i WHERE i.agent_id = :current_contact_id AND status NOT IN ("closed", "resolved")</query>
 <menu>true</menu>
 </dashlet>
 </dashlets>
 </cell>
 </cells>
</dashboard>

状态排序

编辑仪表盘时，值的顺序 可能不是想要的顺序，UI不允许你重新组织它们。
通过使用与上述相同的过程进行XML编辑，可以解决这个问题。
每当再次在UI中编辑此仪表盘时，这项工作都会丢失！因为它会按字母顺序重新排序。

 <values>assigned,dispatched,escalated_tto,escalated_ttr,new,resolved</values>

 <dashlet id="11" xsi:type="DashletHeaderDynamic">
 <rank>0</rank>
 <title>Menu:RequestManagement</title>
 <icon>itop-welcome-itil/images/user-request-deadline.svg</icon>
 <subtitle>Menu:UserRequest:OpenRequests</subtitle>
 <query>SELECT UserRequest WHERE status != "closed"</query>
 <group_by>status</group_by>
 <values>new,dispatched,assigned,escalated_tto,escalated_ttr,resolved</values>
 </dashlet>

快捷方式 ← 上一篇 | 下一篇 → 批量修改

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

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

Docs: 批量修改

Sun, 27 Aug 2023 00:00:00 +0000

在 iTop 中，有两种方法可以进行批量修改：

交互式 CSV 导入：这对于重新导入一组已导出并修改的数据非常有用。
列表上的修改操作：这对于数据清理（规范化）很有用，当希望将一组对象内的值进行对齐时，或者在需要以相同方式修改许多对象时很有用。

交互式 CSV 导入

iTop 提供了强大的 CSV 导入功能，以帮助终端用户（和管理员）在 iTop 中批量创建或更新对象。

CSV 导入 故意不会 在值上应用任何过滤器，就像在控制台中编辑对象时一样。它也不会应用任何预填充。但是在保存对象时进行相同的检查。

要启动 CSV 导入向导，请单击 数据管理 部分中的 CSV 导入 菜单。

只有具有 批量修改 权限的用户才允许使用交互式 CSV 导入。

CSV 模板

iTop 为创建/导入任何类别的对象提供了 CSV 模板。你可以从 CSV 导入向导的第三个选项卡模板中下载或复制/粘贴模板。

从下拉列表中选择所需的类以生成模板。然后单击 大的 Excel 图标 以下载模板，或从图标下面的文本区域中复制/粘贴文本。

获得填充模板的另一种方法是从 CSV 中导出现有对象。有关如何执行此任务的详细说明，请参见导出数据。

值的预期格式

为了加载某些类型的属性，需要以特定的格式提供它们的值。

关联集合（LinkedSet）

点击这里了解导入关系所需的格式。

日期

导入数据的日期格式可以在导入过程中指定，但是源文件中的所有日期必须使用相同的格式。这个格式可以是你的 iTop 上默认的格式，也可以是指定的任何格式。

包含 HTML 的文本

你可以提供带有标签的原始 HTML。示例：

加粗
是的

图片/文件（2.4 中的新增功能）

某些类别包含图片或文件文档作为其字段之一。例如，人员类别包含一个 Picture 字段，用于保存此人的照片。在交互式编辑人员时，用户可以从计算机上传图像以提供人的照片。然而，在执行 CSV 导入时，不可能"上传"此类文件，也不能将其内容放在 CSV 文件本身中，因为 CSV 格式不支持这样做。

在这种情况下，CSV 文件必须在适当的 CSV 列中提供 用于上传文件的 URL。这个 URL 必须能够从 iTop 服务器访问，并返回预期的图像（或文件文档）。如果上传失败，或者上传的文档格式与字段的预期格式不匹配（例如，如果 URL 对于 picture 字段不返回图像），则此字段的导入/更新将失败（整个 CSV 行将被拒绝）。

限制：

URL 必须直接指向要上传的图像（不支持重定向）

URL 必须可以从 iTop Web 服务器访问（注意，一些公共网站可能会拒绝 PHP 脚本的访问 - 它们会检查 HTTP User Agent 字符串）

URL 不能需要身份验证，因为上传是由 iTop 服务器自身执行的

支持指向 iTop 本身的 URL（例如，CSV/Excel 导出提供的 URL）。但仅当它们指向同一个 iTop 实例时（在这种情况下，导入将解析所提供的 URL，并从 iTop 数据库中读取文档）。

如果使用 管理员帐户 执行 CSV 导入，可以指定位于 iTop 服务器本身上的文件路径（但这仅适用于管理员）。

外部对象

要加载作为对其他对象的外部键的属性，可以提供作为远程类的"一致属性"声明的任何组合的属性。

例如：如果要加载用户请求并设置发起人（caller_id），则可以提供以下列的任何组合来标识发起人：

Caller->Email
Caller->Organization name
Caller->First Name
Caller->Last Name
Caller->Full Name
Caller->Employee number

标签集合（TagSet）

要加载标签集合属性，必须以带有 | 分割的标签的标签导入。最好在开头和末尾都放置一个标签。

上传数据

CSV 导入的第一步是将数据上传到服务器。你可以从计算机上传文件，也可以直接将数据复制/粘贴到向导的第二个选项卡中。

要从计算机上传文件，请在向导的第一个选项卡上使用文件上传表单。确保你还选择了用于保存文件的适当字符集。

如果下拉列表中没有你使用的字符集，请联系您的 iTop 管理员（通过 csv_import_charsets 配置变量可以配置此列表）。

如果选择复制/粘贴数据，请使用向导的第二个选项卡 复制和粘贴数据：

然后单击 下一步 » 以继续进行向导的下一步。

以下参数在此步骤中必须进行调整：

参数	意义
分隔符字符	这是用于在 CSV 文件内部分隔不同列的字符。如果在页面底部的预览中正确显示并分隔列，那么当前的选择就是正确的（CSV 文件的典型选择是逗号）
文本限定符字符	有时单元格内的值包含分隔符字符。此类字段然后由文本限定符字符括起来，以防止分隔符字符在单元格中间被错误解释。（典型值是单引号或双引号）
将第一行视为标头	如果文件的第一行包含标头（列名）而不是实际数据，请选中此复选框。请注意，在页面底部的预览中，标头行以不同的颜色显示。
在开始处跳过 `x` 行	一些 CSV 文件（通常是手动创建的脚本生成的 CSV 文件）在文件的开始部分包含一些注释。使用此设置来告诉 iTop 忽略所需数量的行以跳过注释。跳过的行会从页面底部的预览中移除。
日期格式	指定您的源数据中的日期和日期时间字段是以哪种格式编写的。您必须为源数据中的所有日期使用单个格式。如果日期不需要指定时间，如果日期时间不包含任何时间信息，则将使用 00:00:00

如果预览中的重音字符未正确显示，请使用 « 返回 按钮返回向导的第一页，并在再次上传 CSV 文件之前选择适当的字符集。

一旦预览中的数据看起来正确，点击 下一步 » 按钮以继续向导的下一步：

导入向导的第三步是定义CSV文件的列与iTop对象字段之间的映射关系。首先：在下拉列表中 选择要导入的类。这将确定可用于映射的字段列表。如果您想要的类不在列表中：

或许您没有足够的访问权限，您需要在该类上拥有 bulk-modify 权限才能允许导入CSV对象。
或许无法导入该类的对象，对于一些iTop内部类（CMDBChange，CMDBChangeOp，Event等），甚至对于管理员也是如此。

字段映射

如果CSV文件最初是使用模板或iTop的CSV导出功能创建的，那么CSV中提供的标题应该会自动为您提供正确的映射关系。

如果不是这种情况，您将需要手动创建这些映射。

向导要求为要导入数据的每一列提供映射。不过，您可以通过选择 – 忽略该栏 – 作为该列的映射来忽略某列（即不导入该列）。

搜索条件

CSV导入向导可用于在iTop中创建或更新对象。向导在此步骤使用所定义的 搜索条件 来确定CSV文件的每一行是否对应于iTop中的现有对象。如果对象存在，则将对其进行更新；否则将创建新对象。通常情况下，在iTop的搜索表单中，所有选定的 搜索条件 都会使用AND运算符进行组合。（即对象的每个搜索条件都必须匹配才视为匹配项）。

在iTop中，完全相同的导入CSV文件可能会因所选的 搜索条件 不同而产生不同的结果。在此阶段定义的搜索条件将影响所创建或更新的对象数量。

高级用法（管理员专用） 管理员可以访问 高级模式（页面右上角的复选框），该模式允许根据对象的内部标识符（ID或Key编号）导入对象。这对于从iTop中导出并重命名对象非常有用。请勿将此选项用于未从iTop导出的对象，或者至少确保您了解正在导入的数据！高级模式 还允许管理员像此处所述导入 链接集合（LinkedSet）。

设计提示（管理员专用） 每个类在数据模型中都定义了"协调属性"。如果在加载中提供了这些属性，则它们会自动设置为"搜索条件"。如果用户希望通过加载更新其中一些搜索条件，必须取消选中它们，并使用其他条件来检索iTop对象。一旦映射和搜索条件看起来正确，请通过点击 模拟导入 按钮进行导入模拟。

模拟导入

几秒钟后，将显示以下摘要界面：

错误行以红色背景突出显示。错误不会阻止导入运行，但相应的行将被拒绝。

该界面提供了有关未能理解的内容的反馈。

人员状态中的"active"值是枚举类型的字段，但未能理解。active是存储在数据库中的实际代码，但这不是iTop在此处所期望的，它期望该代码在用户语言环境下的标签，所以您应该提供首字母大写的"Active"。
没有名为"IT Department2"的组织。→ 小心，这可能是由于当前用户无权查看该特定组织。
iTop无法确定您想要使用的巴黎位置。在这个示例中，数据库包含两个巴黎位置，一个位于"IT Department"组织下，另一个位于"Demo"组织下。

要解决最后一个错误，请重新启动加载并在Excel中 添加一个新列，以指定"位置->所有者组织的名称"。

注1：最后一行的映射是手动完成的（第一列和第二列的值不同），因为我不知道"位置组织"的确切预期命名。

注2：尝试映射所提供的位置名称时，它不会检查此位置是否与数据模型中定义的筛选器相匹配。出于优化性能的考虑，当加载大量数据时，特意做出了这个技术选择。

注意要创建的对象数量、要更新的对象数量以及错误数量。您可以使用页面顶部的复选框来筛选显示，以更快地分析结果。

如果模拟结果看起来奇怪，可能是 搜索条件 不正确。然后按下返回按钮更改它们并再次进行模拟。如果需要修改数据，请点击 |« 重来（复制和粘贴数据 选项卡将包含上传的数据副本）。如果模拟看起来正确，请点击 执行导入！ 执行实际导入。

执行导入

如果导入的对象数量和要创建或更新的对象百分比超过一定水平，将显示确认对话框：

点击确定关闭对话框并继续进行数据导入。

向导的最后一个界面显示了导入过程中执行的操作摘要。

处理错误

在发生错误的情况下，被拒绝的行会列在报告底部，可以将其复制/粘贴，并在重新导入之前进行修正。

另一种方法是进行迭代：

完成导入向导，并记录哪些行出现了错误。包含错误的行将被简单地忽略。
在您的引用CSV文件中修复出现错误的行。
使用您的引用CSV文件（整个文件）重新运行导入。
重复直到没有错误。

iTop将忽略未更改的行，因为相应的数据已经是最新的（除非在两次导入之间被其他人修改）。如果您需要维护数据的引用CSV文件，则迭代整个CSV文件可能是首选。

修改操作

iTop允许对一组对象进行批量修改。此操作非常有用，可以在一次操作中将多个对象的字段设置为相同的值。

批量修改。这仅在列表中的所有对象都属于相同类别的情况下才可能实现。例如，不能对联系人列表执行修改操作，因为列表可能包含团队和个人。如果要执行此操作，请确保将搜索范围缩小到仅涵盖一个对象类别。
受限访问。并非所有用户都被允许执行批量操作。如果下拉列表中没有显示菜单项，请请求管理员检查您的iTop帐户的安全配置。
修改大量对象。（几百个或更多）可能需要较长的时间来执行。由于出于安全原因，所有交互操作都有时间限制（超时），在执行重要修改之前，请联系管理员以检查是否允许/可持续在交互模式下执行。用于大规模更新操作的备选解决方案是准备一个CSV文件，在服务器上直接以命令行模式加载。

从 其他操作 菜单项中选择修改，将显示以下页面：

在这一步中，您可以选择要更新的对象。默认情况下，所有对象都被选中，从而进行修改。浏览列表以检查是否存在问题，然后点击 下一步 » 继续到下一个界面。

对象修改表单 显示了每个字段旁边的复选框和数值指示器。指示器显示了在所选对象的所有字段中存在多少不同的值。如果所有对象的该字段具有相同的值，则指示器为绿色，复选框已选中且字段可编辑。否则，指示器为红色，复选框未选中。当鼠标指针位于红色指示器上方时，将显示工具提示，显示有关字段的不同值的信息。

只有与复选框对应的字段将被修改。所有其他字段将保持不变。通过选中红色指示器（即包含多个不同值的字段）前的复选框，可以将所有值强制修改为相同的值。

点击 预览修改 » 以显示确认界面：

检查列表查看错误列中是否报告了任何错误，准备就绪后，点击 全部修改 以执行实际的批量修改。

编辑仪表盘 ← 上一篇 | 下一篇 → 理解审计

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

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

Docs: 理解审计

Sun, 27 Aug 2023 00:00:00 +0000

审计是iTop的一项功能，旨在检查iTop数据库中存储的信息的一致性。审计用于回答诸如：“我们是否为生产中的任何设备定义了活动的支持合同？“或"我们是否知道所有服务器的本地化以便进行现场支持？”

这些验证被称为 审计规则。

审计规则 分组成 审计类别。类别定义了必须符合规则的对象（范围）的列表。此范围是动态计算的。换句话说，当显示审计页面时，计算要检查的对象列表。

审计规则 定义了需要检查范围内每个对象的实际约束。例如，“设备必须连接到至少一个启用的供应商合同”。

要添加或修改 审计类别 或 审计规则，请向您的iTop管理员询问。只有管理员被允许管理审计类别和规则。

理解审计报告

通过单击 数据管理 菜单中的审计链接，可以交互地运行审计。

审计报告列出了所有需要审计的类别。对于每个类别，标题行包含：

该类别中的对象数量
具有 至少一个错误 的对象数量（由该类别中的规则报告）
该类别中没有任何错误的对象的百分比
然后，对于每个规则，附加行指示：
- 有关该规则的错误对象数量。单击数字会显示错误对象列表。
- 该规则下没有错误的对象的百分比

批量修改 ← 上一篇 | 下一篇 → 废弃对象

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

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

Docs: 废弃对象

Sun, 27 Aug 2023 00:00:00 +0000

iTop 2.4引入了数据模型，现在每个对象类都定义了一个废弃概念，通过高亮显示/隐藏废弃对象来提高用户体验。

高亮显示废弃对象

废弃的对象会在控制台中进行标记，通过图标和标签使此显而易见。

在列表上：

在对象上：

改进的影响分析

废弃对象在影响分析中被忽略。

废弃 ESX1 之前：

废弃 ESX1 之后：

隐藏废弃对象

基于用户偏好，从iTop控制台的 显示列表 中移除定义为废弃的对象。

废弃对象详情 不会考虑用户偏好而显示。

请小心使用此用户偏好，它确实隐藏了现有对象：

修改模式

在详细信息界面上，下拉列表：不会提供废弃对象。
在关系选项卡中，不会显示废弃对象，因此无法删除。
在关系选项卡中，无法添加废弃对象。

其他显示差异

搜索菜单 和 快捷方式 显示不包含废弃对象的列表
组件不包括废弃对象
全局搜索 不返回废弃对象
批量修改不会修改废弃对象
审计不会在废弃对象上报告审计错误
运行查询 不返回废弃对象
CSV导出 应返回不包含废弃对象的列表

在此模式下仍然可以通过 CSV导入 废弃对象

理解审计 ← 上一篇 | 下一篇 → Excel报表

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

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

Docs: 电子表格报表

Sun, 27 Aug 2023 00:00:00 +0000

如何使用iTop查询创建电子表格报表

从iTop获取数据

管理员可以在iTop中存储预定义查询（菜单"管理/查询手册"）。这些查询然后可以用于在Excel中创建报表。查询通过编号进行标识。在Excel中使用由iTop管理员提供的URL调用它。例如，存储在查询短语本中的下面的URL返回用户请求列表：

然后，您可以使用此URL查询与您的 favorite 电子表格应用程序：

Excel
Libre Office
WPS Office
OnlyOffice

Excel 报表

有两种模式可以自动从iTop提取数据到Excel：基本身份验证（也称为传统的从Web查询）和Power Query Builder

	从Web查询	Power Query Builder
登录	基本身份验证，使用登录名/密码	Token
iTop 用户	iTop 本地用户	用户Token（使用任何类型的iTop用户）或应用程序Token
支持查询变量	是	否
支持多行（文本&HTML）字段	是	否
export-v2 支持的格式	csv, spreadsheet, html	csv only
凭据安全性	登录名/密码不需要存储在表格中	Token 自动以明文形式存储在文件中

传统从Web查询

先决条件

Web服务器必须授权基本身份验证
iTop login_mode 包含 basic
用户必须是 “iTop 本地用户”（并且该用户未配置MFA）

激活此模式

点击菜单项"数据" / “从Web获取”。如果您得到类似于下面的对话框（PowerQuery），则不行。

而是应该得到类似于这样的对话框：

要使用旧的 GetExternalDataFromWeb 向导，请按照以下步骤进行：

进入"文件" / “选项"菜单

点击左侧的"自定义功能区"菜单：

在左上角的下拉列表中，选择"主选项卡”，在显示的树中，打开"数据"项目，并选择菜单项"从Web获取"

要将命令添加到功能区中，您必须创建一个新的"组"（使用对话框底部的按钮）。该组具有默认名称，但如果愿意，可以重新命名它：

类似地，您可以重新命名菜单并选择一个图标。一旦菜单添加到功能中，您应该会看到类似于这样的东西：

当单击自定义菜单时，应该会出现"External Data From Web"向导：

构建报表

要在Excel中使用此查询，请在Excel选项卡数据中单击 From Web 按钮

会显示一个窗口用于输入要调用的URL：

在地址部分输入iTop管理员提供的URL，然后单击 Go。

iTop身份验证窗口会显示。输入您的用户帐户和密码：

单击确定：如果系统提示您的安全弹出窗口。

New Web Query 会更新为要导入的列的列表：

单击 Import 按钮。Excel会询问您要在何处插入数据：

如果查询包含参数，Excel将打开多个连续的窗口以输入这些参数。请注意，日期参数仅支持格式 年-月-日。

单击确定按钮，Excel会显示查询的结果。用于显示列的语言与您在iTop中的登录的默认语言相对应。

要刷新数据，请在Excel的数据选项卡上单击 Refresh All 按钮：

您可以使用尽可能多的iTop查询，并使用标准Excel功能动态地创建图表。

Power Query Builder

先决条件

login_mode token 必须启用
用户Token 或应用程序Token

构建报表

假设您在iTop中创建了一个Web查询，可以使用此URL调用

http://localhost/itop/webservices/export-v2.php?format=csv&login_mode=token&query=109

打开Excel，并使用新的向导模式导入

假设您在iTop中创建了个人Token并复制了该token。

	在新的向导弹出窗口中：
a.	选择 Advanced（默认模式是 Basic）
b.	在字段 URL parts 中输入：`http://localhost/itop/webservices/export-v2.php?format=spreadsheet&login_mode=token&query=109`
c.	在字段 HTTP request header parameters (optional) - 输入 Auth-Token（而不是 auth_token）- 从iTop粘贴Token值。
d.	按确定按钮，

在新的弹出窗口中，使用 Navigator

1. 点击表格	2. 按 Load 按钮	3. 在Excel表格中获取结果

迁移到 Power Query Builder

现有的电子表格将需要重新制作

首先查看 Query Builder 的要求
对于每个电子表格，使用csv格式在url中重新创建相应的Power Query，这将自动创建一个新工作表，因此您的数据透视表和计算将需要更新
变量不再可用，因此您需要在iTop中创建多个 QueryPhrases
多行数据不能再导出（因为Query Builder仅支持csv格式）

LibreOffice 报表

该软件的默认配置与iTop兼容：无需更改任何设置。

要在LibreOffice Calc中使用iTop查询，请选择要插入数据的单元格。然后，单击菜单 Sheet > External links… 或 Data 选项卡中的 External links 按钮

将显示 External data 窗口以输入要调用的URL：

在 URL of External Data Source 部分输入iTop管理员提供的URL，然后按键盘上的 Enter 键。

将显示iTop身份验证窗口。输入您的用户帐户和密码：

然后您可以调整导入选项。如果您没有特殊需求，默认设置即可：

Available Tables/Ranges 将更新为要导入的表格列表。要仅获取一个表格，请选择 HTML_1：

单击确定按钮，LibreOffice Calc 将显示查询结果。用于显示列的语言与您在iTop中登录的默认语言相对应。

要刷新数据，请单击菜单 Edit > Links to External files…，然后在 Edit Links 窗口中单击 Update 按钮。

您可以使用尽可能多的iTop查询，并使用标准LibreOffice Calc功能动态地创建图表。

WPS Office 报表

请按照 WPS Office 编辑器网站上的 howto 进行操作。

要在WPS Office中使用iTop查询，请转到 Data 选项卡，然后单击按钮 Import Data > From Web…。

要在WPS Office中更新iTop查询，请转到 Data 选项卡，然后单击按钮 Refresh All。

OnlyOffice 报表

OnlyOffice 似乎不支持Web查询。您可以访问编辑器网站上的 reference documentation，以检查较新版本是否有更改。

常见问题

为什么值以单引号开头？

由于安全修复，自 iTop 3.2.3 / 3.3.0 起，值前面会加上单引号，以避免CSV注入漏洞。这可能会破坏一些现有的电子表格，如果您信任导入的数据并希望禁用此保护，可以在导出URL中添加 &ignore_excel_sanitization=1。

→上一篇：废弃对象

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

版本：3_2_0/user/excel_report.txt · Last modified: 2026/04/24 15:34 by 127.0.0.1

iTopCN – 最终用户手册

Docs: 连接到iTop

登录界面

首次连接到iTop

Docs: 主界面

用户菜单

标准门户

用户首选项

退出iTop

修改密码

关于 iTop

菜单栏

欢迎页

展开 & 折叠

打开一个菜单组

在菜单中搜索

组织

Docs: 管理首选项

语言

列表

标签栏

富文本编辑器

活动面板

其他设置

快速访问

快捷方式

键盘快捷键

用户的默认头像

Docs: 对象显示和修改

显示

标头

操作

选项卡

对象修改

活动面板

工单日志独立编辑

历史记录过滤

提及用户

展开 & 折叠

并发访问

处理工单附件

拖拽

管理对象关系

多个关系

变更

增加

移除

简单关系

Docs: 操作

新建

修改

删除

关系

上下文

将图表导出为PDF文档

邮件

CSV 导出

Excel 导出

打印友好版本

工单变化

对象特定的操作

Docs: 搜索

场景

添加条件

设定标准

删除条件

保存搜索

重新搜索

搜索功能

文本

数字

选择列表

对象

层次结构

日期

最近使用

全局搜索

Docs: 管理列表

配置列表

邮件