Wiki source code of iTop编辑仪表盘

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