Wiki source code of iTop编辑仪表盘

Last modified by superadmin on 2024/12/12, 20:53
Show last authors
1 = 编辑仪表盘 =
2
3
4
5 ➡️ 介绍如何配置仪表盘。
6
7
8 == 编辑仪表盘 ==
9
10
11 iTop 中的某些页面是**仪表盘**。仪表盘用于在同一页上显示有关不同 iTop 对象的信息。大多数**概览**页面以及**欢迎**页面都是仪表盘。在 iTop 2.0 中，每个用户都可以通过编辑现有的仪表盘页面来定制自己的仪表盘，但是不能够创建新的仪表盘页面。
12
13
14 当页面是可编辑的仪表盘时，在页面右上角会出现小的**笔状**下拉菜单，靠近**退出**菜单旁边。
15
16
17 [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-popup-menu-create.png||alt="仪表盘弹出菜单"]]
18
19
20 要编辑当前页面，请选择**新建自定义版本**。
21
22
23 几秒钟后，一个弹出对话框会出现，其中包含**仪表盘编辑器**对话框：
24
25
26 [[[[image:https://www.itophub.io/wiki/media?w=800&tok=42bc35&media=3_1_0:user:dashboard-editor.png||alt="仪表盘编辑器对话框"]]>>url:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-editor.png]]
27
28
29 仪表盘由名为**组件**的构建块组成。
30
31
32 仪表盘本身排列了包含组件的显示。仪表盘仅具有三个属性：
33
34 * 布局（一列、两列或三列）
35 * 可选标题
36 * 自动刷新设置（禁用，或以秒为单位的刷新间隔）
37
38 布局确定如何在页面上排列组件：它确定了一个网格，每个组件都分配给网格的一个单元格。当布局更改时，单元格（以及单元格内的组件）将重新组织以产生所需的显示。
39
40
41 [[[[image:https://www.itophub.io/wiki/media?w=500&tok=d9cb5f&media=3_1_0:user:dashboards-layouts.png||alt="仪表盘布局"]]>>url:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboards-layouts.png]]
42
43
44 要编辑组件的属性，请在对话框的左侧单击它。选择的组件周围会出现橙色边框，并且组件的属性将显示在对话框的右侧。要修改组件的外观，只需在右侧修改属性。组件将根据你的修改而改变。要从仪表盘中删除所选的组件，请单击所选组件右上角的~*~*//红色叉//~*~*。
45
46
47 要将新的组件添加到仪表盘中，请将其中一个组件图标拖动到仪表盘的所需区域，然后在右侧调整属性以完成仪表盘。
48
49
50 [[[[image:https://www.itophub.io/wiki/media?w=800&tok=c3d6f8&media=3_1_0:user:dashboard-edition2.png]]>>url:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-edition2.png]]
51
52
53
54 (% class="box infomessage" %)
55 (((
56 你还可以从任何 iTop 对象列表创建新的组件。有关如何执行此操作的更多信息，请参见[[管理列表>>url:http://wiki.itop.work/docs/enduser/07-managing_lists/]]。
57 )))
58
59
60 在编辑完成后，点击~*~*//保存//~*~*，保存修改并返回 iTop 页面。
61
62
63 要撤消自从点击**编辑此页面**以来所做的所有修改，请点击~*~*//取消//~*~*。
64
65
66 (% class="box infomessage" %)
67 (((
68 仪表盘的修改适用于当前用户。所有其他用户会保留自己的仪表盘副本（或默认仪表盘，如果他们未自定义它的话）
69 )))
70
71 == ==
72
73 == 组件（Dashlet）类型 ==
74
75
76 以下是用于构建 iTop 仪表盘的不同类型的组件：
77
78
79 |=图标|=名称|=描述
80 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-text.png||alt="文本"]]|文本|一个自由文本区域。用于在页面上添加标题或内容。
81 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-list.png||alt="列表"]]|对象列表|以表格形式显示 iTop 对象的列表，类似于任何搜索结果。
82 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-pie-chart.png||alt="饼图"]]|饼图|iTop 对象的列表，根据给定字段分组并显示为饼图。**2.5 版本新增**：除计数外，还可以在指定字段上使用各种功能（求和、平均、最小和最大值）。还可以指定排序方向和最大结果数。
83 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-bar-chart.png||alt="柱状图"]]|柱状图|iTop 对象的列表，根据给定字段分组并显示为柱状图。**2.5 版本新增**：除计数外，还可以在指定字段上使用各种功能（求和、平均、最小和最大值）。还可以指定排序方向和最大结果数。
84 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-groupby-table.png||alt="分组（表）"]]|分组（表）|iTop 对象的列表，根据给定字段分组并显示为表格。**2.5 版本新增**：除计数外，还可以在指定字段上使用各种功能（求和、平均、最小和最大值）。还可以指定排序方向和最大结果数。
85 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-header.png||alt="标头"]]|标头|左侧带有图标和标题的灰色横栏。
86 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-header-stats.png||alt="带计数的标头"]]|带计数的标头|左侧带有图标、标头和一个表格的灰色横栏，显示按给定字段分组的对象计数。
87 |[[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-badge.png||alt="徽章"]]|徽章|带有文本的图标，显示给定类别的对象总数，并提供两个链接：“创建…” 和 “搜索…”。
88
89 == ==
90
91 == 动态组件 ==
92
93
94 大多数组件在其属性中都包含了一个 OQL（对象查询语言）。这些 OQL 可以根据当前用户、当前时间以及当前对象（如果存在）进行调整，实现动态效果。
95
96 如果仪表盘是一个 菜单 仪表盘，您可以使用前两种方法。
97
98
99 === 基于当前用户 ===
100
101
102 **:current_contact_id**：这是与连接用户关联的联系人的 ID，如果用户未关联联系人，则为 0。它允许显示当前用户是处理人的工单，例如：
103
104 {{{SELECT Ticket WHERE agent\_id \= :current\_contact\_id
105 }}}
106
107 === ===
108
109 === 基于时间 ===
110
111
112 在下面的 OQL 示例中，我们显示过去 30 天内创建且尚未关闭的工单：
113
114 {{{SELECT Ticket
115 WHERE creation\_date \> DATE\_FORMAT(DATE\_SUB(NOW(), INTERVAL 30 DAY),'%Y-%m-%d 00:00:00')
116 AND STATUS !\= 'closed'
117 }}}
118
119 === ===
120
121 === 基于当前对象 ===
122
123
124 仅适用于在对象上定义的仪表板属性，您可以使用当前对象的任何字段来过滤您的 OQL。
125
126 例如，在组织（Organization）上，您可以使用占位符 :this->_att_code_，其中 _att_code_ 可以是组织的任何字段，包括 id。
127
128 {{{SELECT UserRequest WHERE org\_id\=:this\->id
129 }}}
130
131 == ==
132
133 == 编辑自定义版本 ==
134
135
136 一旦创建了特定仪表盘的自定义版本，只能编辑自定义版本
137
138 [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-popup-menu-edit.png||alt="编辑仪表板的自定盘版本"]]
139
140 == ==
141
142 == 在不同版本之间切换 ==
143
144
145 在浏览仪表盘时，你可以随时在自定义版本和标准版本之间切换显示。
146
147 * 橙色建筑图标表示处于**标准版本**： [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-icon-standard.png||alt="标准仪表板图标"]]
148 * 橙色人物图标表示正在查看**自定义版本**： [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-icon-custom.png||alt="自定义仪表板图标"]]
149
150 == ==
151
152 == 导出仪表盘 ==
153
154 ----
155
156 * 仪表盘定义可以导出为XML文件，用于存档或与其他用户共享。
157 * 要导出仪表板，请点击菜单项 **//导出到文件…//**。
158 * 在提示时，输入下载位置（导出的仪表盘将保存到计算机上的位置）。
159
160 [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-popup-menu-export.png||alt="导出仪表板"]]
161
162 == ==
163
164 == 导入仪表盘 ==
165
166 ----
167
168 [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-popup-menu-import.png||alt="导入仪表板"]]
169
170 要从XML文件导入仪表盘定义，请点击 **//从文件导入…//**，然后从计算机上选择要上传的XML文件。
171
172 [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-upload.png]]
173
174
175 如果在尚未自定义的仪表板菜单上导入仪表板，系统将自动创建一个自定义版本。
176
177 当在已存在自定义版本的情况下导入仪表板时，该自定义版本将会丢失。 如果想要保留该版本，请先导出它。
178
179 == ==
180
181 == 打印仪表板 ==
182
183 ----
184
185 可以选择纸张方向，然后使用浏览器的打印菜单：
186
187 [[[[image:https://www.itophub.io/wiki/media?w=500&tok=563ad7&media=3_1_0:user:dashboard-printed-version.png||alt="打印版本的仪表板"]]>>url:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-printed-version.png]]
188
189 == ==
190
191 == 放弃定制内容 ==
192
193 ----
194
195 [[image:https://www.itophub.io/wiki/media?media=3_1_0:user:dashboard-popup-menu-delete.png]]
196
197
198 随时可以放弃仪表盘的定制内容。只需点击 **//删除自定义版本…//**，然后在弹出的确认对话框进行确认。
199
200 == ==
201
202 == 高级自定义 ==
203
204
205 === 拆分单元格 ===
206
207
208 有时手动重新组织仪表盘会有些困难，特别是当在一个单元格中有许多仪表盘并且想要将它们拆分成多个单元格时。
209
210 1. 在仪表盘上，选择操作 导出到文件… 并将文件保存到您的计算机上
211 1. (((
212 使用 XML 编辑器进行编辑，输入下面的代码片段，其中想要拆分单元格的位置
213
214 * 每次粘贴代码时，**将 X 替换为一个唯一的数字**，以标识仪表盘中新单元格的顺序
215 )))
216 1. 保存文件
217 1. 在你的 iTop 仪表盘上选择操作 从文件导入… 并上传保存的 XML 文件
218
219 [[单元格分隔符>>url:https://www.itophub.io/wiki/page?do=export_code&id=3_1_0:user:dashboards&codeblock=3]]
220
221 {{{ </dashlets\>
222 </cell\>
223 <cell id\="X"\>
224 <rank\>X</rank\>
225 <dashlets\>
226 }}}
227
228 描述仪表盘的一个XML文件样例：
229
230 [[仪表板导出>>url:https://www.itophub.io/wiki/page?do=export_code&id=3_1_0:user:dashboards&codeblock=4]]
231
232 {{{<?xml version\="1.0"?>
233 <dashboard xmlns:xsi\="http://www.w3.org/2001/XMLSchema-instance"\>
234 <layout\>DashboardLayoutOneCol</layout\>
235 <title\>Menu:WelcomeMenuPage</title\>
236 <auto\_reload\>
237 <enabled\>false</enabled\>
238 <interval\>300</interval\>
239 </auto\_reload\>
240 <cells\>
241 <cell id\="0"\>
242 <rank\>0</rank\>
243 <dashlets\>
244 <dashlet id\="1" xsi:type\="DashletHeaderStatic"\>
245 <rank\>0</rank\>
246 <title\>Menu:ConfigManagementCI</title\>
247 <icon\>../images/icons/icons8-database.svg</icon\>
248 </dashlet\>
249 <dashlet id\="2" xsi:type\="DashletBadge"\>
250 <rank\>1</rank\>
251 <class\>BusinessProcess</class\>
252 </dashlet\>
253 <dashlet id\="3" xsi:type\="DashletBadge"\>
254 <rank\>2</rank\>
255 <class\>ApplicationSolution</class\>
256 </dashlet\>
257 <dashlet id\="4" xsi:type\="DashletBadge"\>
258 <rank\>3</rank\>
259 <class\>Contact</class\>
260 </dashlet\>
261 <dashlet id\="5" xsi:type\="DashletBadge"\>
262 <rank\>4</rank\>
263 <class\>Location</class\>
264 </dashlet\>
265 <dashlet id\="7" xsi:type\="DashletBadge"\>
266 <rank\>5</rank\>
267 <class\>Server</class\>
268 </dashlet\>
269 <dashlet id\="8" xsi:type\="DashletBadge"\>
270 <rank\>6</rank\>
271 <class\>NetworkDevice</class\>
272 </dashlet\>
273 <!-- You want to split here -->
274 <dashlet id\="11" xsi:type\="DashletHeaderDynamic"\>
275 <rank\>0</rank\>
276 <title\>Menu:RequestManagement</title\>
277 <icon\>itop-welcome-itil/images/user-request-deadline.svg</icon\>
278 <subtitle\>Menu:UserRequest:OpenRequests</subtitle\>
279 <query\>SELECT UserRequest WHERE status != "closed"</query\>
280 <group\_by\>status</group\_by\>
281 <values\>new,assigned,escalated\_tto,escalated\_ttr,resolved</values\>
282 </dashlet\>
283 <dashlet id\="12" xsi:type\="DashletObjectList"\>
284 <rank\>1</rank\>
285 <title\>UI:WelcomeMenu:MyCalls</title\>
286 <query\>SELECT UserRequest AS i WHERE i.agent\_id = :current\_contact\_id AND status NOT IN ("closed", "resolved")</query\>
287 <menu\>true</menu\>
288 </dashlet\>
289 </dashlets\>
290 </cell\>
291 </cells\>
292 </dashboard\>
293 }}}
294
295 === ===
296
297 === 状态排序 ===
298
299 * 编辑仪表盘时，**值的顺序**可能不是想要的顺序，UI不允许你重新组织它们。
300 * 通过使用与上述相同的过程进行XML编辑，可以解决这个问题。
301 * 每当再次在UI中编辑此仪表盘时，这项工作都会丢失！[[:-(>>url:https://www.itophub.io/lib/images/smileys/icon_sad.gif]]，因为它会按字母顺序重新排序。
302
303 {{{ <values>assigned,dispatched,escalated\_tto,escalated\_ttr,new,resolved</values>
304 }}}
305
306 [[[[image:https://www.itophub.io/wiki/media?w=600&tok=db49a3&media=3_1_0:user:dashlet-header-bad-order.png]]>>url:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-header-bad-order.png]]
307
308 {{{ <dashlet id\="11" xsi:type\="DashletHeaderDynamic"\>
309 <rank\>0</rank\>
310 <title\>Menu:RequestManagement</title\>
311 <icon\>itop-welcome-itil/images/user-request-deadline.svg</icon\>
312 <subtitle\>Menu:UserRequest:OpenRequests</subtitle\>
313 <query\>SELECT UserRequest WHERE status != "closed"</query\>
314 <group\_by\>status</group\_by\>
315 <values\>new,dispatched,assigned,escalated\_tto,escalated\_ttr,resolved</values\>
316 </dashlet\>
317 }}}
318
319 [[[[image:https://www.itophub.io/wiki/media?w=600&tok=08ee16&media=3_1_0:user:dashlet-header-good-order.png]]>>url:https://www.itophub.io/wiki/media?media=3_1_0:user:dashlet-header-good-order.png]]
320
321
322 (% class="box infomessage" %)
323 (((
324 [[快捷方式>>https://www.itil4hub.cn/bin/view/G%20%E5%8F%82%E8%80%83%E8%B5%84%E6%96%99/%E5%BC%80%E6%BA%90ITIL%E8%BD%AF%E4%BB%B6%20-%20iTop%E5%AE%9E%E6%96%BD%E6%96%B9%E6%B3%95/iTop%E6%9C%80%E7%BB%88%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C/iTop%E5%BF%AB%E6%8D%B7%E6%96%B9%E5%BC%8F/]]  ← 上一篇 | 下一篇 → [[批量修改>>https://www.itil4hub.cn/bin/view/G%20%E5%8F%82%E8%80%83%E8%B5%84%E6%96%99/%E5%BC%80%E6%BA%90ITIL%E8%BD%AF%E4%BB%B6%20-%20iTop%E5%AE%9E%E6%96%BD%E6%96%B9%E6%B3%95/iTop%E6%9C%80%E7%BB%88%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C/iTop%E6%89%B9%E9%87%8F%E4%BF%AE%E6%94%B9/]]
325 )))
326
327 ----
328
329 原文：[[https:~~/~~/www.itophub.io/wiki/page?id=3_1_0:user:dashboards>>url:https://www.itophub.io/wiki/page?id=3_1_0:user:dashboards]]
330
331 版本：3_1_0/user/dashboards.txt · Last modified: 2023/07/21 10:19 (external edit)
深圳市艾拓先锋企业管理咨询有限公司