×

扫描二维码登录本站

QQ登录

只需一步,快速开始

二次开发-调整门户-门户定制概述

标签: 暂无标签
本帖最后由 adminlily 于 2020-12-16 11:18 编辑

门户定制概述
从iTop 2.3.0开始,门户带有完全可定制的品牌新版本。这使您可以对其进行整形,使其以接近零的编码完全适合您的终端用户需求。

目标听众
您是一名开发人员,顾问。您已经熟悉以下方面的基本知识iTop XML设计.

门户可以做什么?
  • 访问权利,菜单,表格:这些均以XML定义,因此可以轻松更改
  • 可定制:从配置到外观
  • 可扩展的:通过开发模块(如扩展)来添加(和重用)新的职能型功能,并在XML中对其进行配置
  • 多个实例:设置多个实例配置,以使其能够访问仅需要的内容,以适合您的各种终端用户需求。


这个怎么运作
对象安全
数据安全基于数据模型安全布局,实例无法访问的内容超出了控制台允许的范围。另外,必须明确允许在实例上用于可视化和版本化的对象,这有助于您使安全保持用户可以访问的范围。

实例功能
门户的每个实例都有自己的配置,使它们彼此完全独立。

一个实例由几个“砖”组成,每个砖都具有自己的职能型功能,例如创建对象,浏览对象集合等。Bricks拥有自己的配置,但依赖于实例配置,并且无法覆盖它。

共有6种类型的积木:

  • CreateBrick:显示对象创建表单
  • BrowseBrick:浏览对象的分层并为每个级别指定操作活动(查看或编辑对象,从该级别创建另一个对象)。可以从多个视图(例如常规列表或树)中进行导航。用例可能是浏览对象目录,以查找用于创建您的请求的目录。
  • ManageBrick:允许通过在2轴上对对象进行分组和编辑来管理对象。通常用于管理正在进行的请求或一组配置项。
  • FilterBrick:预过滤另一块砖
  • AggregatePageBrick:具有一对多砖瓦的页面。
  • UserProfileBrick:显示带有当前用户信息的表单,以便他可以编辑其中的一些信息。

可以将具有相同配置的多个相同类型的块添加到同一实例,只要它们具有不同的ID。此外,可以开发更多的砖块以适合其他需求(显示图片,嵌入iframe或视频等)。

配置实例
配置是在 /itop_design/module_designs/module_design[@=“<PORTAL_ID>”]节点下的数据模型中制成的。

对于默认的配置,它的配置已拆分为几个模块,因此可以适应各种设置,但是主要部分位于/itop_design/module_designs/module_design[@=“itop-portal”].下的/datamodels/2.x/itop-tickets/datamodel.itop-tickets.xml中. .

依赖在您的设置选择上,可以在itop-request-mgmt, itop-request-mgmt-itil, itop-incident-mgmt-itil, itop-full-itil, itop-knownerror-mgmt and itop-portal中找到其他部分。

对象范围
配置实例时,您应该做的第一件事就是为门户中应访问的所有对象设置范围。这将是所有积木逻辑的基石。不启用对象类可能会因积木而导致意外行为。

一旦确定了您希望用户查看和编辑的内容,范围就很容易定义。

  • 选择对象类
  • 为用户可以查看的对象指定OQL查询
  • (可选)为用户可以编辑的对象指定OQL查询。该查询将应用于“查看”查询中的对象子集。如果未指定,则用户将无法编辑此类的对象。
  • (可选)为此范围指定允许的用户简档(角色)。这意味着您可以在用户的简档(角色)上允许不同的作用域依赖。

如果未定义类,则门户会尝试找到定义最接近的父来检索其范围。如果没有,访问将被拒绝。

范围适用于对象表单中的外部键,但不适用于请求模板的OQL字段。

对象表格
现在定义了作用域,您需要定义如何通过门户显示那些对象。默认情况下,将显示一个基本表单,其中包含“详细信息” z列表中的所有属性,但是您可以根据优化的layout和dor adddhide属性对其进行自定义。

表单是为一种或多种模式(查看,创建,编辑)的特定类(及其子类)定义的。如果没有定义的与类模式匹配的表单,它将回退到默认模式。

您可以选择指定要显示的属性列表,在这种情况下,它们会像默认的表单一样依次显示。或者,您可以给出一个HTML布局,门户将用正确的标记填充。 Bootstrap类和Twig运算符都可以使用。

您还可以在属性上设置标志,它们将与数据模型生命周期中的标志合并。

在这两种情况下,如果未指定门户,它们都会自动将当前状态的必需属性附加到表单。这是将对象保持一致状态的故障保护。

功能规则
功能规则是在某些情况下应用于砖块的行为,例如在对象上预设值或定义提交取消表单时定义要打开的页面。它与语法中的ObjectCopier相似,但没有某些限制。

功能规则可以在多个砖中使用,但并非所有砖都支持它们。从今天起,它们只能在BrowseBrick和CreateBrick中使用。

砖块
配置实例块应该是您配置实例的最后一步,因为它依赖于之前的所有实例。请记住,它们基于数据模型的安全和实例的范围。
每个积木都有其自己的配置和规格,请查看引用指南以获取详细信息。

定制化的外观
新的门户基于知名的框架,例如Twig用于HTML布局,Boostrap用于样式,您还可以使用字体库,因为Font awesome和Glyphicons也被嵌入。这使您可以找到许多在线资源和示例。

更改Bootsrap主题
通过更改引导主题,您可以轻松地变更的门户的全局外观。在线提供了许多免费主题,如果您愿意,您甚至可以构建。

检查一下www.bootswatch.com 或操作方法中的“ sample-门户-new-theme”示例模块。

改变布局
如果您必须全部编写HTML标记,则更改布局会稍微复杂一点,但是它将使您能够自由调整所需的形状。

您可以覆盖多个级别的布局:

  • 门户的整体结构
  • 主页
  • 通用砖页面
  • 每个砖块内容布局

有关示例,请检查“sample-portal-alter-twig示例模块。

Twig模板被缓存到改进性能。如果要在开发期间跳过树枝渲染缓存,只需将调试参数添加到url并将其设置为true。






上一篇:二次开发-调整门户
下一篇:二次开发-调整门户-门户限制
Alan

写了 298 篇文章,拥有财富 719,被 3 人关注

您需要登录后才可以回帖 登录 | 立即注册
B Color Link Quote Code Smilies

成为第一个吐槽的人

最新100贴|论坛版块|ITIL先锋论坛 |粤ICP备11099876号|网站地图
Powered by Discuz! X3.4 Licensed  © 2001-2017 Comsenz Inc.
返回顶部