iTopCN – 门户定制

Docs: 查看更多或更少的工单

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

本文档介绍如何修改用户门户中可见的工单列表。通过修改 Ticket 的 Scope（范围），可以控制用户能看到哪些工单。更多详细内容请参考 iTop 官方文档。

概述

使用场景：允许用户不仅查看自己作为呼叫者的工单，还能查看自己被添加为联系人的工单。

前提条件

熟悉教程中使用的语法
已创建扩展
熟悉 XML 门户逻辑
拥有安装了增强版门户的 iTop 系统
拥有 “Portal User” 角色的账户
能够修改数据模型定义（创建扩展或使用 ITSM Designer）

XML 门户逻辑

对于我们的使用场景，只需要修改 Ticket 的 Scopes（范围）。范围定义了对于给定类，具有或不具有特定角色的用户可以查看或修改的对象。

现有工单范围

默认的工单范围是：

all：普通 “Portal user” 只能查看自己作为"呼叫者"的工单
portal-power-user：“Power Portal user” 可以查看其组织中的所有工单

<module_design id="itop-portal">
 <classes>
 <class id="Ticket">
 <scopes>
 <scope id="all">
 <oql_view><![CDATA[
 SELECT Ticket AS T WHERE T.caller_id = :current_contact_id
 AND T.finalclass IN ('UserRequest', 'Incident')]]>
 </oql_view>
 <!-- oql_edit 与 oql_read 组合 -->
 <!-- 您永远不能修改无法查看的内容 -->
 <!-- 以下查询对读取没有进一步限制 -->
 <oql_edit><![CDATA[SELECT Ticket AS T]]></oql_edit>
 <!-- 没有 allowed_profiles 标签，因此此范围适用于所有用户 -->
 </scope>
 <scope id="portal-power-user">
 <oql_view><![CDATA[
 SELECT Ticket AS T WHERE T.org_id = :current_contact->org_id
 AND T.finalclass IN ('UserRequest', 'Incident')]]>
 </oql_view>
 <oql_edit><![CDATA[SELECT Ticket AS T]]></oql_edit>
 <!-- 此范围仅适用于具有特定角色的用户 -->
 <allowed_profiles>
 <allowed_profile id="Portal power user"/>
 </allowed_profiles>
 </scope>
 </scopes>

修改范围

添加新范围

以下是一个新的 Ticket 范围，允许"任何门户用户查看他们被链接为联系人的工单"：

<classes>
 <class id="Ticket" _delta="must_exist">
 <scopes>
 <scope id="all-in-contacts" _delta="define">
 <oql_view><![CDATA[
 SELECT Ticket AS T
 JOIN lnkContactToTicket AS l ON l.ticket_id = T.id
 WHERE l.contact_id = :current_contact_id
 AND T.finalclass IN ('UserRequest', 'Incident')]]>
 </oql_view>
 <!-- 没有 oql_edit 标签意味着此范围不提供写入权限 -->
 </scope>
 </...>

此新范围的特点：

适用于所有用户
不提供对被链接为联系人但非呼叫者的工单的写入权限

修改现有范围

也可以使用以下方法：

<classes>
 <class id="Ticket" >
 <scopes>
 <scope id="all" _delta="must_exist">
 <oql_view _delta="redefine"><![CDATA[
 SELECT Ticket AS T
 JOIN lnkContactToTicket AS l ON l.ticket_id = T.id
 WHERE l.contact_id = :current_contact_id
 AND T.finalclass IN ('UserRequest', 'Incident')
 UNION
 SELECT Ticket AS T WHERE T.caller_id = :current_contact_id
 AND T.finalclass IN ('UserRequest', 'Incident')]]>
 </oql_view>
 </scope>
 </...>

修改后的特点：

仍然适用于所有用户
提供对被链接为联系人或呼叫者的工单的写入权限
但无法单独限制对被链接为联系人但非呼叫者的工单的编辑

其他使用场景

限制为团队管理的工单

类似的使用场景是将 “Power Portal user” 的工单可见性限制为由其团队管理的工单：

SELECT Ticket AS T
 JOIN Team AS G ON T.team_id = G.id
 JOIN lnkPersonToTeam AS l ON l.team_id = G.id
WHERE T.org_id = :current_contact->org_id
 AND T.finalclass IN ('UserRequest', 'Incident')
 AND l.person_id = :current_contact->id

扩展到子组织的工单

另一个使用场景是将 “Power Portal user” 的工单可见性扩展到其子组织的工单：

SELECT Ticket AS T
 JOIN Organization AS root ON T.org_id = root.id
 JOIN Organization AS child ON child.parent_id BELOW root.id
WHERE T.org_id = :current_contact->org_id
 AND T.finalclass IN ('UserRequest', 'Incident')

限制为允许的组织（不级联）

如何防止具有允许组织的门户用户查看其允许组织的子组织的工单：

默认情况下，iTop 会级联用户允许组织的子组织的访问权限。在 3.1.0 中，没有直接方法阻止此行为。
以下 OQL 范围是门户用户严格限制在其允许组织的变通方法。
注意：这样做将阻止没有允许组织的门户用户查看任何工单

SELECT Ticket AS T
 JOIN Organization AS O ON T.org_id=O.id
 JOIN URP_UserOrg AS AO ON AO.allowed_org_id=O.id
 JOIN USER AS U ON AO.userid = U.id
WHERE U.contactid = :current_contact_id
 AND T.finalclass IN ('UserRequest', 'Incident')

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

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

Docs: 创建新门户

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

本文档介绍如何从零开始创建一个全新的 iTop 门户实例。需要掌握 XML 配置、类范围（Scope）、表单定义、Brick 配置和 UrlMaker 注册等知识。更多详细内容请参考 iTop 官方文档。

概述

本教程介绍如何从零开始创建一个全新的门户。您仍然需要参考门户 XML 参考，因为它提供了所有定制可能性，而本教程仅涵盖部分内容。如果下面的教程过于详细，可以先阅读门户定制概述。

前提条件

熟悉教程中使用的语法
已创建扩展

门户声明

首先需要在 XML 中声明门户：

指定哪些用户可以访问，哪些不能。不是直接指定用户，而是指定角色（Profile）。
注意：控制台本身也是一个门户，具有特定的 ID（id=backoffice），在允许或拒绝角色方面的工作方式相同。

默认声明

以下是 iTop 默认的声明方式：

<portals>
 <portal id="itop-portal"> <!-- 用户门户 -->
 <...>
 <allow/> <!-- 未指定角色，表示允许所有角色 -->
 <deny/> <!-- 无限制，这就是为什么普通控制台用户也能访问 -->
 </portal>
 <portal id="backoffice"> <!-- 控制台 -->
 <...>
 <allow/> <!-- 允许或拒绝可以组合使用，但组合使用可能会很奇怪 -->
 <deny> <!-- 拥有以下角色的用户将被拒绝 -->
 <profile id="Portal user"/>
 </deny> <!-- deny 优先于 allow -->
 </portal>
</portals>

示例需求

假设我们要创建一个新门户，同时保留标准用户门户（id=itop-portal）和控制台。

当拥有超过 2 个门户时，定义角色会变得复杂。需要想象所有情况，但允许和拒绝角色的组合可能会导致死锁。

新门户必须限制为仅拥有新创建的角色"Extension Publisher"的用户访问。这些用户不能访问控制台，可能可以也可能不可以访问标准 itop-portal，取决于他们是否拥有 “Portal user” 角色。

公司用户没有 “Portal user” 角色，否则他们将无法访问控制台。但我们仍然允许他们访问新门户。为此，我们将创建一个新角色 “XX employee”（XX 为公司名称）。

可能的声明方式

以下是声明 3 个门户以实现上述需求的一种方式：

<portals>
 <portal id="backoffice" _delta="must_exist">
 <deny _delta="redefine">
 <profile id="Portal user"/>
 <profile id="Extension Publisher"/>
 </deny>
 </portal>
 <portal id="itop-portal" _delta="must_exist">
 <allow _delta="redefine">
 <profile id="Portal user"/>
 <profile id="XX employee"/>
 </allow>
 </portal>
 <portal id="extension-publisher-portal" _delta="define">
 <url>pages/exec.php?exec_module=itop-portal-base&amp;exec_page=index.php&amp;portal_id=extension-publisher-portal</url>
 <rank>1.0</rank>
 <handler/>
 <allow>
 <profile id="Extension Publisher"/>
 <profile id="XX employee"/>
 </allow>
 <deny/>
 </portal>
</portals>

门户设计

需要指定以下内容：

classes：哪些类和对象将在门户中显示
forms：每个类的字段可见性和布局（创建、查看、编辑）
bricks：定义导航菜单和 Brick

类 / 范围（Scopes）

范围用于显式指定将在门户中使用的类。除非已为某个类定义了范围，否则该类在门户中永远不可见，无论您的角色是什么。即使您是管理员也不足够。

用户可见的内容

范围定义了在类中，用户可以查看的对象实例。
以下示例指定了一个读取范围，适用于所有访问门户的用户，不是因为 ID 是 “all”，而是因为未指定 <allowed_profiles> 标签，这意味着所有角色都被允许。

<scope id="all">
 <oql_view><![CDATA[SELECT Ticket WHERE (Condition1) ]]></oql_view>
</scope>

范围可以通过 <allowed_profiles> 标签限制为特定角色的用户。
如果多个范围适用于同一用户，则它们将通过 UNION 组合。

示例：拥有 “Portal power user” 角色的用户可以看到由范围 “power” 定义的工单，以及范围 “all” 中的工单。

<scope id="power">
 <oql_view><![CDATA[SELECT Ticket WHERE (Condition2) ]]></oql_view>
 <allowed_profiles>
 <allowed_profile id="Portal power user"/>
 </allowed_profiles>
<scope>

最终，用户将看到以下 OQL 返回的任何工单：

SELECT Ticket WHERE (Condition1) UNION SELECT Ticket WHERE (Condition2)

用户可修改的内容

范围还可以定义用户可以修改的对象。用户永远不允许修改他无法查看的对象，因此在指定可修改内容时，只需指定额外的限制（如果需要）。
例如，如果用户应该被允许修改他能看到的任何工单：

<scope id="all">
 <oql_edit><![CDATA[SELECT Ticket]]></oql_edit>
</scope>

这将允许用户修改所有他能看到的工单，无论 <oql_view> 查询如何。

忽略组织限制

门户用户可能通过其 iTop 用户的 “Allowed organizations” 设置被限制在自己的组织内。这是相当常见的，特别是对于服务提供商。
然而，在用户级别定义的组织限制可以被门户范围覆盖。这不是自动的，范围必须显式声明忽略用户的允许组织。 这仅适用于该范围。
标准"用户门户"中有一个示例，使用户能够看到服务目录，即使这些服务不属于用户的组织：

<class id="Service">
 <scopes>
 <scope id="all">
 <oql_view>
 <![CDATA[
 SELECT Service AS s JOIN lnkCustomerContractToService AS l1 ON l1.service_id=s.id
 JOIN CustomerContract AS cc ON l1.customercontract_id=cc.id
 WHERE cc.org_id = :current_contact->org_id AND s.status != 'obsolete'
 ]]>
 </oql_view>
 <ignore_silos>true</ignore_silos>
 </scope>
 </scopes>
</class>

重要提示

由于必须在任何门户上激活 UserProfileBrick，以下范围也必须在每个门户上声明：

<class id="User">
 <scopes>
 <scope id="all">
 <oql_view>
 <![CDATA[SELECT User AS U JOIN Person AS P ON U.contactid=P.id WHERE P.id = :current_contact_id]]>
 </oql_view>
 </scope>
 </scopes>
</class>

拒绝转换（Transitions）

允许阻止某些角色的用户在门户中执行他们通常被允许但在该门户中不应该执行的转换，而应该在控制台或其他门户中执行。

列表显示

此部分允许指定当对象作为另一个类的表单中的 LinkedSet 或 LinkedSetIndirect 属性时，应显示哪些字段。如果未指定，则显示的字段列表将与控制台中的相同。

表单（Forms）

表单指定了类对象在门户中的显示方式，包括字段呈现及其标志：只读、可写、必填。

对于给定类，您只能有一个表单来定义如何查看对象。但可以有不同模式的不同表单：

一个用于对象创建
一个用于修改
一个用于查看
每个转换一个表单

这些表单可以特定于某个场景或在多个场景中重用。

Brick

Brick 是门户的功能模块。有关 Brick 配置的详细信息，请参考门户 XML 参考。

UrlMaker

UrlMaker 类允许 iTop 构建指向特定 GUI（例如您的新门户）的 URL。如果没有为门户注册 UrlMaker，则多个地方的 URL 将格式错误（例如在通知中）。

需要执行以下操作：

创建 2 个专用的 PHP 类，为该门户生成正确的（查看或编辑）URL
在门户中注册此类
全局注册这些类，以便在通知中生成指向该门户的 URL

PHP 代码示例：

<?php

use Combodo\iTop\Portal\UrlMaker\AbstractPortalUrlMaker;

require_once APPROOT.'/lib/autoload.php';

/**
 * 指向对象"编辑"页面的超链接
 */
class MyPortalEditUrlMaker extends AbstractPortalUrlMaker
{
 const PORTAL_ID = 'my-portal';
}

/**
 * 指向对象"查看"页面的超链接
 */
class MyPortalViewUrlMaker extends MyPortalEditUrlMaker
{
 /**
 * @inheritDoc
 */
 public static function MakeObjectURL($sClass, $iId)
 {
 return static::PrepareObjectURL($sClass, $iId, 'view');
 }
}

// 默认门户超链接（用于通知）是查看超链接
DBObject::RegisterURLMakerClass('my-portal', MyPortalViewUrlMaker::class);

在门户 XML 定义中：

<module_design id="my-portal" _delta="define">
 <properties>
 <urlmaker_class>MyPortalViewUrlMaker</urlmaker_class>
 <!-- ... -->
 </properties>
 <!-- ... -->
</module_design>

完整 XML 示例

以下是一个完整的门户 XML 配置示例，展示了如何定义类、范围、表单、Brick、操作规则和导航规则：

<module_design id="my-portal" _delta="define">
 <properties>
 <name>Developers portal</name>
 <urlmaker_class>MyPortalViewUrlMaker</urlmaker_class>
 <triggers_query>
 <![CDATA[SELECT TriggerOnPortalUpdate AS t WHERE t.target_class IN (:parent_classes)]]>
 </triggers_query>
 </properties>
 <classes>
 <class id="User">
 <scopes>
 <scope id="all">
 <oql_view>
 <![CDATA[SELECT User AS U JOIN Person AS P ON U.contactid=P.id WHERE P.id = :current_contact_id]]>
 </oql_view>
 </scope>
 </scopes>
 </class>
 <class id="Organization" _delta="define">
 <scopes>
 <scope id="all">
 <oql_view><![CDATA[SELECT Organization WHERE id = :current_contact->org_id]]></oql_view>
 </scope>
 </scopes>
 </class>
 </classes>
 <!-- 更多配置... -->
</module_design>

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

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

Docs: 门户 XML 参考

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

本文档是 iTop 客户门户 XML 配置的完整参考。您必须熟悉 iTop XML 设计的基础知识。更多详细内容请参考 iTop 官方文档。

概述

您必须熟悉 iTop XML 设计的基础知识。

有关客户门户定制功能的概述，请查看页面定制您的客户门户。

结构

此结构特定于基于 itop-portal-base 库开发的门户。

全局结构标签

标签	用途	说明
`<module_design id="PORTAL_UNIQUE_ID" xsi:type="portal">`	必填	定义门户实例配置的结构节点
`<properties>`	必填	实例的全局属性
`<name>portal:itop-portal</name>`	必填	门户名称，用于门户选择下拉框和门户 logo 图像标题属性
`<logo>../images/itop-logo.png</logo>`	可选	实例中使用的 logo。如果定义，将覆盖 Designer 或 env-xxx/branding/portal-logo.png 中的 logo
`<themes>`	必填	声明的 CSS 样式表
`<theme id="custom">sample-portal-custom-css/custom.css</theme>`	零个或多个	CSS 样式表列表。ID 为 bootstrap\|portal\|custom 的样式表首先加载，重新定义它们将覆盖默认文件。然后加载其他 ID。路径必须相对于 /env-xxx
`<templates>`	必填	声明的 TWIG 模板
`<template id="layout">sample-portal-alter-twig/layout.html.twig</template>`	零个或多个	要覆盖的 TWIG 模板列表。可用值为 “layout”（整个页面）或 “home”（首页内容）。（Brick 内容布局可以在每个 Brick 中直接定义）
`<urlmaker_class>iTopPortalViewUrlMaker</urlmaker_class>`	可选	用于生成对象查看 URL 的类（例如在通知、linksets 中）
`<triggers_query>`	必填	在实例上更新对象时检索触发器的 OQL 查询
`<attachments>`	必填	结构节点
`<allow_delete>true</allow_delete>`	必填	门户中是否可以删除附件。可用值为 true\|false
`<allowed_portals>`	必填	结构节点
`<opening_mode>tab</opening_mode>`	必填	定义其他门户（允许当前用户访问）的打开方式。可用值为 “tab”（新标签页打开）或 “self”（当前标签页打开）。默认值为 “tab”
`<bricks>`	必填	声明的 Brick

Brick 通用标签

标签	用途	说明
`<brick id="BRICK_UNIQUE_ID" xsi:type="ANY_FQCN_BRICK">`	零个或多个	Brick 的声明。ID 必须在集合中唯一。xsi:type 必须是完全限定类名（包括命名空间）。可以有多个相同 xsi:type 的 Brick 实例，只要它们的 ID 不同。请参阅 Brick 类型部分（注意：仅在此节点下显示通用标签）
`<active>true</active>`	可选	Brick 在门户上是否激活。注意，在首页和导航菜单上都不可见的活动 Brick 仍然可以通过其 URL 访问。可用值为 true\|false，默认值为 true
`<width>6</width>`	可选	首页上瓦片的宽度。值必须是 1-12 之间的整数，12 表示整行宽度。默认值为 3
`<rank>`	可选	Brick 在首页和导航菜单上的排名。如果未指定，将放在首位
`<default>1</default>`	可选	首页和导航菜单上的排名。值必须是浮点数
`<home>1</home>`	可选	仅首页上的排名。值必须是浮点数
`<navigation_menu>1</navigation_menu>`	可选	仅导航菜单上的排名。值必须是浮点数
`<title>`	可选	Brick 在首页和导航菜单上的标题
`<description>`	可选	将在首页上显示的 Brick 描述
`<visible>`	可选	Brick 在首页和导航菜单上是否可见。如果未指定，默认在两个上都为 true
`<decoration_class>`	可选	Brick 图标在首页和导航菜单上的 CSS 类。可以使用 Glyphicon、Font Awesome 或您自己的 CSS 类
`<security>`	可选	限制哪些角色可以查看此 Brick
`<allowed_profiles>`	可选	返回可以查看此 Brick 的角色的 OQL。如果省略，则所有未明确拒绝的角色都可以查看
`<denied_profiles>`	可选	不能查看此 Brick 的角色

表单标签

标签	用途	说明
`<forms>`	必填	声明的表单
`<form id="name">`	零个或多个	表单的声明。ID 必须唯一
`<class>ServiceSubcategory</class>`	必填	表单的对象类。子类将继承此表单（如果它们没有定义自己的）
`<properties>`	可选	结构节点
`<display_mode>cosy</display_mode>`	可选	表单字段的显示模式。“cosy” 表示常规标签在值上方的布局；“compact” 表示并排的布局，25% 空间用于标签，75% 用于输入；“dense” 表示并排的布局，输入填充所有可用空间。您还可以使用自定义 CSS 类，该将在表单上用作 “form_xxx”，在字段上用作 “form_field_xxx”。可用值为 cosy\|compact\|dense\|CUSTOM_VALUE，默认值为 cosy
`<always_show_submit>false</always_show_submit>`	可选	设置为 false 时，当对象上有可用转换时隐藏提交按钮。可用值为 true\|false，默认值为 false
`<navigation_rules>`	可选	要应用于此表单的导航规则
`<fields>`	可选	声明的字段。如果为空，则仅显示来自 twig 标签的字段。如果省略，则仅显示来自 zlist details 的字段，twig 标签将被忽略
`<field id="title">`	零个或多个	字段的声明。ID 必须是类的有效属性代码。如果未放置在 twig 标签中，将逐个放置。缺少的必填属性将自动附加到表单
`<twig>`	可选	表单布局。您可以在此标签下使用任何 HTML 标签来制作完美的表单模板。如果未定义，字段将逐个放置
`<modes>`	可选	声明的模式。如果未定义，表单将适用于所有模式
`<mode id="apply_stimulus">`	零个或多个	定义表单对此类可用的模式。可用值为 view\|edit\|create\|apply_stimulus

类标签

标签	用途	说明
`<classes>`	必填	声明的类
`<class id="Contact">`	零个或多个	类的声明。类（或其祖先之一）必须定义才能在实例中显示。ID 必须是有效的对象类
`<scopes>`	必填	声明的范围
`<scope id="name">`	零个或多个	范围的声明。范围定义了角色可以访问的对象集，它们关于用户角色是累积的
`<oql_view>`	必填	定义允许查看的对象集的 OQL 查询
`<oql_edit>`	可选	定义允许编辑的对象集的 OQL 查询。注意，这仅适用于 oql_view 的子集
`<ignore_silos>false</ignore_silos>`	可选	设置为 “true” 时，此范围的 OQL 将不受当前用户允许组织的限制。值可以是 true\|false，默认值为 “false”
`<allowed_profiles>`	可选	声明将有权访问该范围的角色。如果此标签不存在，则所有角色都可以访问该范围
`<lists>`	可选	演示列表。目前，仅在门户中的对象的 LinkedSet 中使用
`<lifecycle>`	可选	生命周期：每个角色禁用的事件，如果省略则应用用户角色定义
`<action_rules>`	可选	声明的操作规则。AR 是在特定 Brick 中、特定操作上应用于对象/表单的操作。它们可以组合
`<navigation_rules>`	可选	声明的导航规则。NR 是定义在单击对象表单的提交/取消按钮后去向的操作

Brick 类型

以下是 itop-portal-base 库中内置的功能。您可以在单独的模块中实现自己的 Brick，只要其名称（即 xsi:type）不与现有 Brick 冲突。

UserProfileBrick

用户个人资料编辑 Brick。

标签	用途	说明
`<show_picture_form>true</show_picture_form>`	可选	显示/隐藏用户头像表单。可用值为 true\|false，默认值为 true
`<show_preferences_form>true</show_preferences_form>`	可选	显示/隐藏用户偏好设置表单。可用值为 true\|false，默认值为 true
`<show_password_form>true</show_password_form>`	可选	显示/隐藏用户密码表单。可用值为 true\|false，默认值为 true
`<form>`	必填	连接用户的联系信息编辑表单。行为与门户的全局表单完全相同，请参阅相应部分

BrowseBrick

浏览对象层次结构，并为每个级别指定操作（查看或编辑对象、从此对象创建另一个对象）。可以从多个视图进行导航，如常规列表或树。一个用例是浏览服务目录以找到要创建请求的服务。

标签	用途	说明
`<levels>`	必填	声明的级别
`<level id="UNIQUE_ID">`	必填	级别的声明。ID 必须唯一，整数更安全，避免使用 ‘-’
`<class>ServiceFamily</class>`	可选	此级别上显示的对象类。如果存在 oql 标签则忽略
`<oql>`	可选	定义要显示的对象类子集的 OQL 查询。如果定义则优先于 class 标签
`<actions>`	可选	该级别对象的可用操作
`<browse_modes>`	必填	浏览模式列表
`<availables>`	必填	可用浏览模式列表
`<default>list</default>`	必填	默认浏览模式。必须是可用浏览模式之一：list\|tree\|mosaic
`<default_list_length>20</default_list_length>`	可选	设置列表默认显示的项目数。可用值为 10\|20\|50\|-1
`<data_loading>auto</data_loading>`	必填	定义数据加载方式。可用值为 auto\|full\|lazy

ManageBrick

通过在两轴上分组来管理对象并编辑它们。通常用于管理正在进行的请求或一组 CI。

标签	用途	说明
`<class>Ticket</class>`	可选	要管理的对象类。如果未定义 oql 标签则必填，否则忽略
`<oql>`	可选	定义要管理的对象子集的 OQL 查询。优先于 class 标签
`<opening_target>modal</opening_target>`	可选	定义操作方式。值可以是 “modal”（模态窗口）、“new”（新窗口）或 “self”（当前窗口）。默认值为 “modal”
`<opening_mode>edit</opening_mode>`	可选	定义对象的打开方式。值可以是 edit\|view，默认值为 “edit”
`<fields>`	可选	对象列表中显示的属性列表，如果省略则使用 zlist “list”
`<display_modes>`	可选	显示模式列表，如果省略则仅使用 ’list'
`<grouping>`	必填	声明的分组
`<tabs>`	必填	在标签页上的分组通过 OQL 查询完成，在表格上的分组通过 finalclass 完成
`<export>`	可选	允许用户从详细列表视图导出数据

CreateBrick

显示对象创建表单。

标签	用途	说明
`<modal>true</modal>`	必填	表单是否在模态对话框或整页中。可用值为 true\|false，默认值为 true
`<class>UserRequest</class>`	必填	要创建的对象类。可以是抽象类，系统将提示用户选择最终类
`<rules>`	必填	要应用于表单的操作规则

FilterBrick

预过滤另一个 Brick。

标签	用途	说明
`<search_placeholder_value>`	可选	过滤器字段中显示为占位符的字符串
`<search_submit_label>`	可选	提交按钮的标签
`<search_submit_class>`	可选	要添加到提交按钮的 CSS 类
`<target_brick>`	必填	结构节点
`<id>`	必填	必须与目标 Brick 的 id 对应
`<type>`	必填	必须与目标 Brick 的 xsi:type 对应。目前仅支持 BrowseBrick 和 ManageBrick
`<tab>`	必填	BrowseBrick：用于显示结果的浏览模式（mosaic 除外）。ManageBrick：要显示的标签页（组 id）

AggregatePageBrick

包含一个或多个 Brick 瓦片的页面。

标签	用途	说明
`<aggregate_page_bricks>`	必填	要包含在页面中的 Brick 列表
`<aggregate_page_brick id="PAGE_BRICK_ID">`	至少一个	要包含的 Brick ID
`<rank>1</rank>`	可选	页面中瓦片的排名

导航规则

您可以创建导航规则并从任何表单中调用它们。

可用规则类型

关闭表单：

<navigation_rule id="close-form" xsi:type="close"/>

返回首页：

<navigation_rule id="go-to-homepage" xsi:type="go-to-homepage"/>

转到 ManageBrick：

<navigation_rule id="go-to-resolved-requests" xsi:type="go-to-manage-brick">
 <id>ongoing-tickets-for-portal-user</id>
 <display_mode>list</display_mode>
 <grouping_tab>resolved</grouping_tab>
</navigation_rule>

转到 BrowseBrick：

<navigation_rule id="go-to-services" xsi:type="go-to-browse-brick">
 <id>services</id>
</navigation_rule>

转到对象：

<navigation_rule id="go-to-object" xsi:type="go-to-object">
 <oql>SELECT Ticket WHERE id = :this->id</oql>
 <mode>view</mode>
 <opening_target>modal</opening_target>
</navigation_rule>

然后在任何表单中调用这些导航规则：

<form id="ticket-apply-stimulus">
 <properties>
 <navigation_rules _delta="define">
 <submit>
 <default>go-to-resolved-requests</default>
 </submit>
 <cancel>
 <default>go-to-homepage</default>
 <modal>close-form</modal>
 </cancel>
 </navigation_rules>
 </properties>
</form>

已知限制

自 iTop 3.1.0 版本及安全漏洞修复以来，在门户中添加 UserRequest 和 Person 等之间的关系可能会被拒绝，即使该用户具有有效的 Person 和 UserRequest 范围。用户可能会收到以下错误消息：

Attribute pointing to an object that is either non existing or not readable by the current user:
current_object = lnkContactToTicket::-1, attcode = ticket_id, attvalue = xxx, current_user = UserLocal::xx

根本原因是此关系存储在类 lnkContactToTicket 中，该类包含两个 AttributeExternalKey 类型的字段，一个指向 Ticket 类，另一个指向 Contact 类。

不要犹豫激活门户上的调试日志，以获取更多解释：

'log_level_min' => [\LogChannels::PORTAL => \LogAPI::LEVEL_DEBUG,],

变更历史

XML 版本 1.4

此版本随 iTop 2.4 beta 于 2017 年 7 月发布。

Filter Brick：扩展已包含到核心应用程序中
UserProfileBrick：可以禁用头像、偏好设置和密码表单
BrowseBrick：新增 “mosaic” 模式，方便在小设备上显示与浏览对象关联的图像
ManageBrick：显示标签计数
Create Brick：现在支持抽象类
表单：可配置的显示模式、字典条目可用、LinkedSet 属性可默认打开
可以隐藏某些门户用户的转换

XML 版本 1.5

ManageBrick：提供新的显示类型（饼图、柱状图和徽章）
支持导出到 Excel
新增 AggregatePageBrick

XML 版本 1.7

LinkedSet 属性可以显示（或不显示）超出范围的项目
ManageBrick 支持标签描述
可以更改 Browse 和 Manage Brick 的默认列表大小
Browse Brick 中可以使用 n:n 关系
新增导航规则类型

XML 版本 3.x

自 3.1 版本起，可以在门户中修改 n:n 关系的属性
自 3.2 版本起，附件占位符可以在每个门户表单中移动

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

版本：3_2_0/customization/portal_xml.txt · Last modified: 2026/02/18 17:10 by 127.0.0.1

Docs: 门户定制概述

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

本文档介绍 iTop 门户定制的整体概述。自 iTop 2.3.0 起，门户完全可定制，通过 XML 配置即可实现个性化需求，几乎无需编码。更多详细内容请参考 iTop 官方文档。

概述

自 iTop 2.3.0 起，门户推出了全新的版本，完全可定制。这使您能够根据最终用户的需求进行定制，几乎无需编码。

目标受众

您是一名开发人员或顾问。您已经熟悉 iTop XML 设计的基础知识。

门户能实现什么？

访问权限、菜单、表单：全部在 XML 中定义，可以轻松更改
可定制：从配置到外观和感觉
可扩展：通过开发 Brick（作为扩展）并配置到 XML 中，添加（和重用）新功能
多实例：设置多个实例/配置以满足各种最终用户需求，仅向他们提供所需内容

工作原理

对象安全

数据安全基于数据模型的安全布局，实例无法访问超过控制台允许的内容。此外，在实例上可用于可视化和编辑的对象必须显式允许，这有助于您控制用户可以访问的内容。

实例功能

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

一个实例由多个"Brick"组成，每个 Brick 启用自己的功能，如创建对象、浏览对象集合等。Brick 有自己的配置，但依赖于实例配置，无法覆盖它。

目前有 6 种类型的 Brick 可用：

Brick 类型	说明
CreateBrick	显示对象创建表单
BrowseBrick	浏览对象层次结构，并为每个级别指定操作（查看或编辑对象、从此对象创建另一个对象）。可以从多个视图进行导航，如常规列表或树。一个用例是浏览服务目录以找到要创建请求的服务
ManageBrick	通过在两轴上分组来管理对象并编辑它们。通常用于管理正在进行的请求或一组 CI
FilterBrick	预过滤另一个 Brick
AggregatePageBrick	包含一个或多个 Brick 瓦片的页面
UserProfileBrick	显示当前用户信息的表单，以便他们可以编辑其中一些

可以在同一实例中添加多个相同类型的 Brick，只要它们具有不同的 ID。此外，可以开发更多 Brick 以满足其他需求（显示图片、嵌入 iframe 或视频等）。

配置实例

配置在数据模型中的 /itop_design/module_designs/module_design[@="<PORTAL_ID>"] 节点下进行。

根据您的设置选择，其他部分可以在 itop-request-mgmt、itop-request-mgmt-itil、itop-incident-mgmt-itil、itop-full-itil、itop-knownerror-mgmt 和 itop-portal 中找到。

对象范围

配置实例时，首先要做的是为所有应在门户中访问的对象设置范围。这将是所有 Brick 逻辑的基石。未启用对象类可能会导致 Brick 出现意外行为。

范围一旦确定了用户应该查看和编辑的内容，就很容易定义：

选择对象类
为用户可以查看的对象指定 OQL 查询
（可选）为用户可以编辑的对象指定 OQL 查询。该查询将应用于"查看"查询的子集。如果未指定，用户将无法编辑此类的对象
（可选）为此范围指定允许的用户角色。这意味着您可以根据用户的角色允许不同的范围

对象表单

现在范围已定义，您需要定义这些对象在门户中的显示方式。默认情况下，将显示包含"details" z-list 中所有属性的基本表单，但您可以自定义此布局以优化布局和/或添加/隐藏属性。

表单为特定类（及其子类）定义，用于一个或多个模式（查看、创建、编辑）。如果没有定义匹配类/模式的表单，将回退到默认表单。

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

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

操作规则

操作规则是在特定情况下应用于 Brick 的行为，如预设对象值或定义提交/取消表单时打开的页面。其语法类似于 ObjectCopier，但没有它的一些限制。

操作规则可以在多个 Brick 中使用，但并非所有 Brick 都支持它们。目前它们只能在 BrowseBrick 和 CreateBrick 中使用。

Brick

配置 Brick 应该是配置实例时的最后一步，因为它依赖于所有前面的配置。请记住，它们基于数据模型的安全性和实例的范围。

每个 Brick 都有自己的配置和特性，详细信息请参考参考指南。

定制外观

新门户基于 Twig（HTML 布局）和 Bootstrap（样式）等众所周知的框架，您还可以使用字体库，如 Font Awesome 和 Glyphicons 也已嵌入。这使您能够找到许多在线资源和示例。

更改 Bootstrap 主题

通过更改 Bootstrap 主题，您可以轻松更改门户的整体外观和感觉。许多免费主题可在线获取，您甚至可以构建自己的主题。

查看 www.bootswatch.com 或 how-tos 中的 “sample-portal-new-theme” 示例模块。

更改布局

更改布局稍微复杂一些，因为您必须重新编码 HTML 标记，但这将给您自由塑造它的能力。

可以覆盖多个级别的布局：

全局门户结构
首页
通用 Brick 页面
每个 Brick 内容布局

查看 “sample-portal-alter-twig” 示例模块以获取示例。

Web 分析器

自 iTop 2.7.0 起，门户基于 Symfony。为了便于开发，您可以启用 Symfony 的"Web 分析器"，这是一个开发工具，提供有关请求执行的详细信息。

要启用它：

在同一目录中，复制文件 /datamodels/2.x/itop-portal-base/portal/.env（或 “/env-production/itop-portal-base/portal/.env” 以避免运行安装程序，但这将在下次安装程序运行时被删除）
将复制的文件命名为 .env.local
在此新文件中添加以下行：

APP_ENV=dev

此设置的结果是在门户屏幕底部显示一个横幅。

资源

请参阅客户门户 XML 参考指南

模块参数

itop 门户具有可在 iTop 配置文件中覆盖的模块参数。这些参数对于每个门户实例可能不同。

lazy_loading_threshold

定义告诉 Browse 和 Manage Brick 的自动加载模式在 full 和 lazy 之间切换的阈值：

auto：如果数据计数小于门户实例的 “lazy_loading_threshold” 模块参数，则数据将一次性加载；超过此值将动态加载每个页面/级别
full：所有数据将一次性加载
lazy：数据将在每个页面/级别动态加载

enable_formmanager_content_check

此参数用于 iTop 2.7.6、3.0.0 和 3.0.1，在后续版本（2.7.7、3.0.2 和 3.1.0）中已删除。如果门户扩展返回错误消息 “Twig content not allowed in this context!"，则可以将此参数设置为 ‘false’。

$MyModuleSettings = array(
 'itop-portal' => array( // itop-portal 是 iTop 中包含的用户门户
 // 'lazy_loading_threshold' => '500', 由于这是默认值，因此无需在此处指定
 'enable_formmanager_content_check' => false,
 ),
 'itop-business-portal' => array( // 门户实例的 id，这里是扩展带来的另一个门户
 'lazy_loading_threshold' => '1000',
 'enable_formmanager_content_check' => true, // 由于这是默认值，因此可以省略
 ),
);

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

2024/09/10 10:25 by127.0.0.1

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

Docs: 门户上的可选关系

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

本文档介绍如何在门户中实现基于服务子类别的动态可选 n:n 关系。通过数据模型扩展和 PHP 代码覆盖 GetAttributeFlags() 方法来实现。更多详细内容请参考 iTop 官方文档。

概述

在本教程中，我们将介绍如何使 n:n 关系根据服务子类别动态可选。

使用场景

假设您希望在门户中创建用户请求时，要求用户选择某些应用解决方案，但仅针对某些服务子类别；对于其他服务子类别，您不希望用户被此选项打扰。

实现步骤

要实现此功能，需要执行以下步骤：

在 Service Subcategory 上添加一个 with_as 字段（枚举 yes/no），用于存储是否必须向用户提示 n:n 关系 “Application Solutions”
在 UserRequest 类上创建一个 applicationsolutions_list 的 LinkedSetIndirect，并使其依赖于 servicesubcategory_id
在 User Request 上创建一个 ExternalField with_as，以从 servicesubcategory_id 获取等效字段
修改 Ticket 的门户创建和编辑表单，添加 applicationsolutions_list
覆盖 UserRequest::GetAttributeFlags() 以在适用时隐藏 applicationsolutions_list

PHP 代码实现

public function GetInitialStateAttributeFlags($sAttCode, &$aReasons = array())
{
 if (($sAttCode == 'applicationsolutions_list') && \ContextTag::Check(\ContextTag::TAG_PORTAL) && $this->Get('with_as') =='no')
 {
 return(OPT_ATT_HIDDEN | parent::GetInitialStateAttributeFlags($sAttCode, $aReasons));
 }
 return parent::GetInitialStateAttributeFlags($sAttCode, $aReasons);
}

public function GetAttributeFlags($sAttCode, &$aReasons = array(), $sTargetState = '')
{
 if (($sAttCode == 'applicationsolutions_list') && \ContextTag::Check(\ContextTag::TAG_PORTAL) && $this->Get('with_as') =='no')
 {
 return(OPT_ATT_HIDDEN | parent::GetAttributeFlags($sAttCode, $aReasons, $sTargetState));
 }
 return parent::GetAttributeFlags($sAttCode, $aReasons, $sTargetState);
}

代码说明

GetInitialStateAttributeFlags()：在对象初始状态（创建时）确定属性标志
GetAttributeFlags()：在对象生命周期中确定属性标志
\ContextTag::Check(\ContextTag::TAG_PORTAL)：检查当前上下文是否在门户中
OPT_ATT_HIDDEN：隐藏属性的标志
当 with_as 为 ’no’ 时，隐藏 applicationsolutions_list 字段

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

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

Docs: 门户限制

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

本文档介绍 iTop 门户的当前已知限制。在定制门户时，了解这些限制非常重要。更多详细内容请参考 iTop 官方文档。

概述

以下是定制门户时应了解的一些新门户限制。这些限制可能会在未来版本中改变。

安全 / 访问权限

通过门户创建或编辑对象时，必须满足多个条件，提交才能被服务器接受：

对象必须包含在该用户和类的门户可写范围中 — 此限制无法禁用
所有可编辑的 AttributeExternalKey 字段必须引用用户有权查看的对象 — 此限制无法禁用

要授予用户在门户中查看对象的权限：

对象必须包含在该用户和类的门户范围中
并且：对象属于用户的 allowed_orgs，或范围设置为 ignore_silo，或对象类没有 org_id 字段

归档对象

归档对象在任何用户门户中永远不可见，目前没有计划改变这一点。

组织

默认门户中没有定义用于显示组织的表单，因此所有组织字段都会显示。如果要限制门户用户可见的组织字段，则需要在 iTop 扩展中定义表单。

表单

字段

某些属性类型在门户中不可编辑：

EnumSet 和 TagSet
File 和 Image
Duration

对象搜索

从 ExternalKey 或 LinkedSet 类型的属性搜索对象时，过滤器在 Date / DateTime / Duration / Deadline / HTML 类型的属性上不起作用。

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

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

Docs: 门户字段必填

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

本文档介绍如何在用户门户中强制字段必填。通过修改门户 XML 配置中的 data-field-flags 属性，可以覆盖数据模型中的字段必填设置。更多详细内容请参考 iTop 官方文档。

概述

本教程介绍如何在用户门户中强制某些字段必填。这是一个强制字段必填的特定应用场景。

前提条件

熟悉教程中使用的语法
已创建扩展

使用场景

本示例将介绍如何在用户门户中创建用户请求（UserRequest）时，强制要求填写 service_id 和 servicesubcategory_id 字段。在控制台中，这两个字段在数据模型中不是必填的，且在生命周期中在"已解决"状态之前也不是必填的。

用户门户通过 XML 描述，您可以在 <form> 标签下方修改表单的行为和外观。有关所有可能的配置选项，请参考门户 XML 参考。

实现方法

在门户 XML 中，使用 data-field-flags="mandatory" 属性可以强制字段必填：

<module_design id="itop-portal">
 <forms>
 <form id="ticket-create">
 <class>Ticket</class>
 <fields/>
 <!-- 如果不重新定义整个 twig，则无法修改其中的一部分 -->
 <twig _delta="redefine">
 <div class="row">
 <div class="col-sm-6">
 <!-- data-field-flags 可以强制字段为 mandatory、read_only、hidden -->
 <!-- 或者设置为 must_change（必须修改） -->
 <!-- "mandatory,must_change" 强制字段必须修改为非空值 -->
 <div class="form_field" data-field-id="service_id" data-field-flags="mandatory"></div>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="servicesubcategory_id" data-field-flags="mandatory">
 </div>
 </div>
 </div>
 <!-- [其余 XML 标签...] -->
 </twig>
 </form>
 </forms>
</module_design>

移除必填标志

要移除必填标志，只需重新定义 twig，并在其中移除 data-field-flags="mandatory" 属性。

特殊情况

如果某个字段同时满足以下条件：

在数据模型中必填，或由于生命周期标志而必填
且当前为空
且在门户表单中被指定为 hidden、read_only 或被省略

则门户引擎将忽略这些表单标志，并将该字段作为必填项添加到表单末尾。

原文：https://www.itophub.io/wiki/page?id=3_2_0:customization:mandatory-in-portal

版本：3_2_0/customization/mandatory-in-portal.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 添加 Dashlet

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

本文档介绍如何使用 ManageBrick 在门户中添加 Dashlet。Dashlet 可以是饼图、柱状图、排行榜（top_list）或徽章（badge）。更多详细内容请参考 iTop 官方文档。

概述

在本教程中，我们将使用 ManageBrick 在门户中添加一个 Dashlet。Dashlet 可以是以下类型之一：

饼图（pie chart）
柱状图（bar chart）
排行榜（top list）
徽章（badge）

前提条件

拥有安装了演示数据和增强版门户的 iTop 系统
拥有足够权限访问门户的账户（通常需要 “Portal User” 角色）
能够修改数据模型定义（创建扩展或使用 ITSM Designer）

教程目标

在本教程中，您将学习如何：

向现有门户添加一个新的 Dashlet
支持多种显示模式：饼图、柱状图、排行榜、徽章

示例：进行中工单 ManageBrick

以下 XML 代码将添加一个饼图瓦片到标准用户门户的首页，显示"进行中"与"已解决"工单的分布：

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
 <module_designs>
 <module_design id="itop-portal" xsi:type="portal">
 <bricks>
 <brick id="ongoing-tickets-for-portal-user-ext" xsi:type="Combodo\iTop\Portal\Brick\ManageBrick" _delta="define">
 <active>true</active>
 <rank>
 <default>20</default>
 </rank>
 <width>6</width>
 <title>
 <default>Brick:Portal:OngoingRequests:Title</default>
 </title>
 <description>Brick:Portal:OngoingRequests:Title+</description>
 <decoration_class>
 <default>fa fa-etsy fa-2x</default>
 </decoration_class>
 <oql><![CDATA[SELECT Ticket]]></oql>
 <fields>
 <field id="title"/>
 <field id="start_date"/>
 <field id="status"/>
 <field id="service_id"/>
 <field id="servicesubcategory_id"/>
 <field id="priority"/>
 <field id="caller_id"/>
 </fields>
 <display_modes>
 <availables>
 <mode id="list"/>
 <mode id="pie-chart"/>
 <mode id="bar-chart"/>
 </availables>
 <default>pie-chart</default>
 <tile>badge</tile>
 </display_modes>
 <export>
 <fields>
 <field id="title"/>
 <field id="start_date"/>
 <field id="status"/>
 <field id="service_id"/>
 <field id="servicesubcategory_id"/>
 <field id="priority"/>
 <field id="caller_id"/>
 <field id="description"/>
 </fields>
 </export>
 <grouping>
 <tabs>
 <show_tab_counts>true</show_tab_counts>
 <groups>
 <group id="opened">
 <rank>1</rank>
 <title>Brick:Portal:OngoingRequests:Tab:OnGoing</title>
 <condition><![CDATA[SELECT Ticket AS T WHERE operational_status NOT IN ('closed', 'resolved')]]></condition>
 </group>
 <group id="resolved">
 <rank>2</rank>
 <title>Brick:Portal:OngoingRequests:Tab:Resolved</title>
 <condition><![CDATA[SELECT Ticket AS T WHERE operational_status = 'resolved']]></condition>
 </group>
 </groups>
 </tabs>
 </grouping>
 <data_loading>full</data_loading>
 </brick>
 </bricks>
 </module_design>
 </module_designs>
</itop_design>

将上述 XML 放入扩展中，运行安装程序，然后在门户中查看结果。

关键配置说明

配置项	说明
`display_modes`	定义数据在 ManageBrick 中的显示方式
`availables`	可用的显示模式：list、pie-chart、bar-chart
`default`	ManageBrick 打开时的默认显示模式
`tile`	在首页和 AggregatePageBrick 中的显示方式：text、badge、pie-chart、bar-chart、top-list
`grouping`	按标签页对对象进行分组
`show_tab_counts`	是否显示每个标签页的对象数量

启用导出到 Excel

您可以在每个 ManageBrick 上添加"导出到 Excel"功能。支持两种方式定义要导出的属性：

使用与页面显示相同的属性

<brick xsi:type="Combodo\iTop\Portal\Brick\ManageBrick">
 <export><export_default_fields>true</export_default_fields></export>
</brick>

使用特定的导出字段列表

<brick xsi:type="Combodo\iTop\Portal\Brick\ManageBrick">
 <export>
 <fields>
 <field id="title"/>
 <field id="start_date"/>
 <!-- 更多字段... -->
 </fields>
 </export>
</brick>

这将在相应页面上显示导出按钮。

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

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

Docs: 添加创建按钮

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

本文档介绍如何使用 CreateBrick 在门户中添加一个快捷创建按钮。该按钮可以在门户的任何位置打开对象创建表单。更多详细内容请参考 iTop 官方文档。

概述

在本教程中，我们使用 CreateBrick 添加一个快捷请求按钮。

前提条件

知道如何制作 iTop 扩展并升级系统
拥有安装了演示数据和增强版门户的 iTop 系统
拥有足够权限访问门户的账户（通常需要 “Portal User” 角色）

教程目标

在本教程中，您将学习如何：

向默认门户添加一个 Brick
使用 CreateBrick 创建一个按钮，在门户的任何位置打开创建表单

分步说明

1. 创建扩展

首先，创建一个将修改门户 XML 配置以添加新 Brick 的 iTop 扩展。如有必要，请查看定制指南中的扩展模块部分。

将扩展命名为 sample-portal-add-button
删除 main.sample-portal-add-button.php 文件，因为我们不需要 PHP 代码

2. 修改门户配置

现在扩展已准备好，我们只需要制作一个 XML delta 并更改门户配置以添加 Brick。打开 datamodel.sample-portal-add-button.xml 文件并粘贴以下代码：

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
 <module_designs>
 <module_design id="itop-portal" xsi:type="portal">
 <bricks>
 <brick id="quick-new-user-request" xsi:type="Combodo\iTop\Portal\Brick\CreateBrick" _delta="define">
 <active>true</active>
 <rank>
 <default>70</default>
 </rank>
 <width>4</width>
 <modal>true</modal>
 <title>
 <default>Brick:Portal:QuickNewUserRequest:Title</default>
 </title>
 <visible>
 <home>false</home>
 </visible>
 <decoration_class>
 <default>fa fa-bolt fa-2x fa-fw</default>
 </decoration_class>
 <!-- 将使用表单创建的类 -->
 <class>UserRequest</class>
 <rules>
 <rule id="contact-to-userrequest"/>
 </rules>
 </brick>
 </bricks>
 </module_design>
 </module_designs>
</itop_design>

这个 Brick 的配置说明：

排名：由于排名大于其他 Brick，它将排在首页和导航菜单中其他 Brick 的后面
首页可见性：不在首页显示（home=false）
模态对话框：在模态对话框中打开表单，而不是跳转到完整页面
类：创建 UserRequest 类的对象
规则：应用 contact-to-userrequest 操作规则中的预设值

3. 添加字典条目

编辑 en.dict.sample-portal-add-button.php 文件，为按钮标签添加条目：

<?php
Dict::Add('EN US', 'English', 'English', array(
 'Brick:Portal:QuickNewUserRequest:Title' => 'Quick new request',
));

可以为其他语言重复相同的操作。

4. 升级系统

最后，使用新扩展选项运行 iTop 系统升级并访问门户。您应该在导航菜单上看到新的 “Quick new request” 按钮。点击它，将打开创建表单。

与默认的用户请求创建流程的主要区别是：您无需通过服务目录选择服务子类别，可以直接从门户的任何位置创建对象。

下载

您可以在以下地址找到此扩展及示例主题：sample-portal-add-button-1.0.0-145.zip

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

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

Docs: 添加新的浏览模式

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

本文档介绍如何为 BrowseBrick 添加新的浏览模式。本示例使用 Microsoft Metro UI 风格，但您可以根据需要实现任何样式（如轮播图等）。更多详细内容请参考 iTop 官方文档。

概述

在本教程中，我们将为 BrowseBrick 添加一种新的浏览对象的方式。本示例使用 Microsoft Metro UI 风格，但您可以根据需要实现任何样式（如轮播图 carousel）。

前提条件

知道如何制作 iTop 扩展并升级系统
拥有安装了演示数据和增强版门户的 iTop 系统
拥有足够权限访问门户的账户（通常需要 “Portal User” 角色）
了解 twig 和 CSS 语言（如果要自定义本示例）

教程目标

在本教程中，您将学习如何：

向现有 BrowseBrick 添加新的浏览模式

分步说明

1. 创建扩展

首先，创建一个将修改门户 XML 配置的 iTop 扩展。如有必要，请查看定制指南中的扩展模块部分。

将扩展命名为 sample-portal-add-browse-mode-to-browse-brick
删除 main.sample-portal-add-browse-mode-to-browse-brick.php 文件，因为我们不需要 PHP 代码

2. 创建模板

现在需要创建将为该浏览模式渲染的模板。首先为这个模式选择一个名称，本示例中我们选择 metro。

然后创建一个名为 browsebrick-mode-metro.html.twig 的 twig 文件，并复制粘贴以下代码（文件名不重要）：

{# itop-portal-base/portal/src/views/bricks/browse/mode_tree.html.twig #}
{# Browse brick tree mode layout #}
{% extends 'itop-portal-base/portal/src/views/bricks/browse/layout.html.twig' %}

{% block bBrowseMainContent %}
 <div id="brick-content-metro">
 </div>
{% endblock %}

{% block pPageLiveScripts %}
 {{ parent() }}

 <script type="text/javascript">
 var browseMode = '{{ sBrowseMode }}';
 var levelsProperties = {{ aLevelsProperties|raw }};
 var rawDatas = {{ aItems|raw }};

 $(document).ready(function(){
 for(var i in rawDatas)
 {
 var itemKeys = Object.keys(rawDatas[i]);
 var itemLastLevelAlias = itemKeys[itemKeys.length - 1];

 $('<div class="browse-element vertical-center">'+rawDatas[i][itemLastLevelAlias].name+'</div>').appendTo('#brick-content-metro');
 }
 $('<div style="clear: both"></div>').appendTo("#brick-content-metro");
 });
 </script>
{% endblock %}

开始时我们扩展了 BrowseBrick 布局，这样就不需要重新定义整个页面模板。然后我们放置一些标记来定义对象容器，并添加一个 JavaScript 片段来解析 JSON 数据并填充容器。

现在创建一个 CSS 文件来应用样式。命名为 browsebrick-mode-metro.css 并复制粘贴以下代码：

#brick-content-metro{
 padding: 20px;
}
#brick-content-metro .browse-element{
 float: left;
 margin: 0 0.5% 10px 0.5%;
 width: 19%;
 height: 120px;
 text-align: center;
 background-color: #EA7D1E;
 color: #FFFFFF;
 box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 3px 1px -2px rgba(0, 0, 0, 0.2), 0 1px 5px 0 rgba(0, 0, 0, 0.12)
}
#brick-content-metro .browse-element:hover{
 opacity: 0.85;
 transition: all linear 0.2s;
}

3. 修改门户配置

现在扩展已准备好，我们只需要制作一个 XML delta 并更改门户配置以使用它。打开 datamodel.sample-portal-add-browse-mode-to-browse-brick.xml 文件并粘贴以下代码：

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
 <module_designs>
 <module_design id="itop-portal" xsi:type="portal">
 <properties>
 <themes>
 <theme id="sample-portal-add-browse-mode-to-browse-brick" _delta="define">sample-portal-add-browse-mode-to-browse-brick/browsebrick-mode-metro.css</theme>
 </themes>
 </properties>
 <bricks>
 <brick id="services" xsi:type="Combodo\iTop\Portal\Brick\BrowseBrick">
 <browse_modes>
 <availables>
 <mode id="metro" _delta="define">
 <template>sample-portal-add-browse-mode-to-browse-brick/browsebrick-mode-metro.html.twig</template>
 </mode>
 </availables>
 </browse_modes>
 </brick>
 </bricks>
 </module_design>
 </module_designs>
</itop_design>

这添加了一个 theme 节点用于 Brick 的 CSS，以及一个 mode 节点用于 Brick 的可用浏览模式。确保路径和文件名与您的系统一致。

4. 升级系统

最后，使用新扩展选项运行 iTop 系统升级并访问门户。您将看到新模式现在可在"New request" Brick 的右上角使用。

下载

您可以在以下地址找到此扩展：sample-portal-add-browse-mode-1.0.1-156.zip

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

Last modified: 2024/09/10 10:25 by127.0.0.1

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

Docs: 为他人创建工单

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

本文档介绍如何允许门户中的高级用户（Power User）为组织中的其他人员创建工单。通过修改 caller_id 字段的过滤器来实现。更多详细内容请参考 iTop 官方文档。

概述

使用场景：允许高级用户（Power User）在门户中为组织中的其他人员创建工单。

前提条件

熟悉教程中使用的语法
已创建扩展
熟悉 XML 门户逻辑
拥有安装了增强版门户的 iTop 系统
拥有 “Portal User” 和 “Power User” 角色的账户
能够修改数据模型定义（创建扩展或使用 ITSM Designer）

实现方法

要限制此功能仅对高级用户可用，需要修改数据模型中 Ticket 类的 caller_id 字段的过滤器。过滤器是一个 OQL 查询，根据其他工单字段和/或当前用户定义建议的呼叫者列表。

XML 门户表单

对于我们的使用场景，只需要修改工单创建表单，并在该表单中重新定义 twig 标签。由于 twig 下方的 XML 标签没有 id，您必须始终重新定义该标签的完整内容。

<module_design id="itop-portal" _delta="must_exist">
 <forms>
 <form id="ticket-create" _delta="must_exist">
 <twig _delta="redefine">
 <div class="row">
 <div class="col-sm-6">
 <div class="form_field" data-field-id="service_id" data-field-flags="mandatory"></div>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="servicesubcategory_id" data-field-flags="mandatory"></div>
 </div>
 </div>
 <div id="service_details_placeholder">
 <div class="form_field" data-field-id="service_details"></div>
 </div>
 <div class="row">
 <div class="col-sm-4">
 <div class="form_field" data-field-id="caller_id"></div>
 </div>
 <div class="col-sm-4">
 <div class="form_field" data-field-id="impact"></div>
 </div>
 <div class="col-sm-4">
 <div class="form_field" data-field-id="urgency"></div>
 </div>
 </div>
 <div>
 <div class="form_field" data-field-id="title"></div>
 <div class="form_field" data-field-id="description"></div>
 <div class="form_field" data-field-id="contacts_list"></div>
 </div>
 </twig>
 </form>
 </forms>
</module_design>

caller_id 过滤器

可以通过在 Ticket.caller_id 上设置以下复杂的 filter 标签来更改上述限制（需要 iTop 2.7.0 或更高版本）：

SELECT Person WHERE
(org_id=:this->org_id
AND
 (:current_contact_id NOT IN (SELECT Person AS p
 JOIN USER AS u ON u.contactid=p.id
 JOIN URP_UserProfile AS uup ON uup.userid=u.id
 JOIN URP_Profiles AS up ON uup.profileid=up.id
 WHERE up.name='Portal user' AND p.id = :current_contact_id
 )
 OR :current_contact_id IN (SELECT Person AS p
 JOIN USER AS u ON u.contactid=p.id
 JOIN URP_UserProfile AS uup ON uup.userid=u.id
 JOIN URP_Profiles AS up ON uup.profileid=up.id
 WHERE up.name='Portal power user' AND p.id = :current_contact_id
 )
 )
)
OR (org_id=:this->org_id AND id=:current_contact_id)

这个 OQL 查询的逻辑是：

如果当前用户不是普通 “Portal user”，或者是 “Portal power user”，则允许选择同一组织中的任何人员
否则，只能选择自己

注意：以下更短的查询似乎更简洁，但不起作用。根本原因仍在调查中。

SELECT Person WHERE
(org_id=:this->org_id
AND
 (:current_user->id NOT IN (SELECT USER AS u
 JOIN URP_UserProfile AS uup ON uup.userid=u.id
 JOIN URP_Profiles AS up ON uup.profileid=up.id
 WHERE up.name='Portal user' AND u.id = :current_user->id
 )
 OR :current_user->id IN (SELECT USER AS u
 JOIN URP_UserProfile AS uup ON uup.userid=u.id
 JOIN URP_Profiles AS up ON uup.profileid=up.id
 WHERE up.name='Portal power user' AND u.id = :current_user->id
 )
 )
)
OR (org_id=:this->org_id AND id=:current_contact_id)

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

Last modified: 2024/09/10 10:25 by127.0.0.1

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

Docs: 修改 Bootstrap 主题

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

本文档介绍如何替换门户的默认 Bootstrap 主题。通过创建扩展并添加自定义 CSS 主题文件，可以更改门户的整体外观。更多详细内容请参考 iTop 官方文档。

概述

在本教程中，默认门户的 Bootstrap 主题（Combodo 主题）将被在线找到的另一个主题替换。

前提条件

知道如何制作 iTop 扩展并升级系统
拥有安装了演示数据和增强版门户的 iTop 系统
拥有足够权限访问门户的账户（通常需要 “Portal User” 角色）

教程目标

在本教程中，您将学习如何：

更改门户的 Bootstrap 主题以改变其外观和感觉

分步说明

1. 创建扩展

首先，创建一个将修改门户 XML 配置以定义使用哪个主题的 iTop 扩展。如有必要，请查看定制指南中的扩展模块部分。

将扩展命名为 sample-portal-new-theme
删除 main.sample-portal-new-theme.php 文件，因为我们不需要 PHP 代码

2. 选择新主题

现在扩展已创建，我们需要获取一个新的 Bootstrap 主题来替换 Combodo 主题。在本示例中，我们将使用 bootswatch.com 上的 Simplex 主题，但您可以使用任何与 Bootstrap 3 兼容的主题。

前往 bootswatch.com，下载预编译的 CSS 文件，并将其放入新扩展的文件夹中。

3. 修改门户配置

现在新主题已准备好，我们只需要制作一个 XML delta 并更改门户配置以使用它。打开 datamodel.sample-portal-new-theme.xml 文件并粘贴以下代码：

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3">
 <module_designs>
 <module_design id="itop-portal" xsi:type="portal">
 <properties>
 <themes>
 <theme id="bootstrap" _delta="define_if_not_exists">sample-portal-new-theme/css/bootstrap.min.css</theme>
 </themes>
 </properties>
 </module_design>
 </module_designs>
</itop_design>

这向门户添加了一个 theme 节点。确保包含扩展和文件名的路径与您的系统一致。

4. 升级系统

最后，使用新扩展选项运行 iTop 系统升级并访问门户。

Et voilà !（完成了！）

下载

您可以在以下地址找到此扩展及一些示例主题：sample-portal-new-theme-1.0.1-147.zip

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

Last modified: 2024/09/10 10:25 by127.0.0.1

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

Docs: 修改菜单图标

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

本文档介绍如何修改门户中 Brick 的图标。通过修改门户 XML 配置中的 decoration_class 属性，可以将默认图标替换为 FontAwesome 图标。更多详细内容请参考 iTop 官方文档。

概述

在本教程中，我们将"New request"（新请求）的图标从对话气泡改为纸飞机。

前提条件

知道如何制作 iTop 扩展并升级系统
拥有安装了演示数据和增强版门户的 iTop 系统
拥有足够权限访问门户的账户（通常需要 “Portal User” 角色）

教程目标

在本教程中，您将学习如何：

修改 “New request” Brick 的图标

分步说明

1. 创建扩展

首先，创建一个将修改门户 XML 配置以更改 Brick 图标的 iTop 扩展。如有必要，请查看定制指南中的扩展模块部分。

将扩展命名为 sample-portal-change-brick-icon
删除 main.sample-portal-change-brick-icon.php 文件，因为我们不需要 PHP 代码
删除 *.dict.sample-portal-change-brick-icon.php 文件，因为我们不需要翻译

2. 修改门户配置

现在扩展已准备好，我们只需要制作一个 XML delta 并更改门户配置以定义要使用的图标。打开 datamodel.sample-portal-change-brick-icon.xml 文件并粘贴以下代码：

<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.7">
 <module_designs>
 <module_design id="itop-portal">
 <bricks>
 <brick id="services">
 <decoration_class>
 <default _delta="force">fas fa-paper-plane fa-2x fa-fw</default>
 </decoration_class>
 </brick>
 </bricks>
 </module_design>
 </module_designs>
</itop_design>

这重新定义了 services（即"New request"）Brick 的图标。关键部分：

fas fa-paper-plane：图标类，可在 FontAwesome v5 网站（仅限免费类别）上找到
fa-2x：确保图标在导航菜单中与其他图标大小相同
fa-fw：确保图标在导航菜单中与其他图标一样居中

3. 升级系统

最后，使用新扩展选项运行 iTop 系统升级并访问门户。您应该看到 “New request” 图标已被我们的纸飞机替换。

下载

您可以在我们的 GitHub 上找到此扩展。

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

Last modified: 2024/09/10 10:25 by127.0.0.1

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

Docs: 修改范围

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

本文档介绍如何更改门户中的可见范围（Scope）。包括修改服务目录的默认显示模式、允许支持代理在门户中处理工单等场景。更多详细内容请参考 iTop 官方文档。

概述

本教程介绍如何更改门户中的可见范围，涵盖多个常见使用场景。

修改服务目录的默认显示模式

问题：如何更改服务目录的默认显示模式？

<module_design id="itop-portal" _delta="must_exist">
 <bricks>
 <brick id="services" xsi:type="Combodo\iTop\Portal\Brick\BrowseBrick" _delta="must_exist">
 <browse_modes>
 <default _delta="redefine">mosaic</default>
 </browse_modes>
 </brick>
 </bricks>
</module_design>

允许支持代理在门户中处理工单

使用场景：您有一个主提供商组织，提供多个服务，多个组织购买这些服务。其中一些客户拥有团队和支持代理，他们为主组织的服务交付模型做出贡献，但仅限于作为客户为其组织创建的工单。我们不希望这些代理查看其他客户，也不希望查看主组织的所有工单。

如果他们仅使用控制台，则无法为其组织创建工单，因为他们看不到服务。如果他们使用门户，则需要修改门户，以便他们能够看到交付模型团队和代理，从而能够在组织外分配和分派工单。

允许创建处于新建状态的工单

首先，允许支持代理创建处于新建状态的工单，而无需强制直接分派或分配：

<module_design id="itop-portal" _delta="must_exist">
 <forms>
 <form id="ticket-create" _delta="must_exist">
 <properties _delta="define_if_not_exists">
 <always_show_submit _delta="force">true</always_show_submit>
 </properties>
 </form>
 </forms>
 <classes>
 <class id="Contact" _delta="must_exist">
 <scopes>
 <scope id="agents" _delta="define">
 <oql_view><![CDATA[SELECT Contact ... ]]></oql_view>
 <ignore_silos _delta="force">true</ignore_silos>
 <allowed_profiles>
 <allowed_profile id="Support Agent"/>
 </allowed_profiles>
 </scope>
 </scopes>
 </class>
 </classes>
</module_design>

查询支持代理可见的联系人

以下查询使支持代理能够看到分派和分配工单所需的团队和相关人员（当他们不全部属于用户组织时）。如果都在同一组织中，则此范围无用，标准配置即可：

SELECT Contact AS c
 JOIN lnkPersonToTeam AS l2 ON l2.person_id = c.id
 JOIN Team AS t ON l2.team_id=t.id
 JOIN lnkDeliveryModelToContact AS l1 ON l1.contact_id=t.id
 JOIN DeliveryModel AS dm ON l1.deliverymodel_id=dm.id
 JOIN Organization AS o ON o.deliverymodel_id=dm.id
 WHERE o.id = :current_contact->org_id
UNION SELECT Contact AS c
 JOIN lnkDeliveryModelToContact AS l1 ON l1.contact_id=c.id
 JOIN DeliveryModel AS dm ON l1.deliverymodel_id=dm.id
 JOIN Organization AS o ON o.deliverymodel_id=dm.id
 WHERE o.id = :current_contact->org_id

其他使用场景

限制为团队管理的工单

类似的使用场景是将 “Power Portal user” 的工单可见性限制为由其团队管理的工单：

SELECT Ticket AS T
 JOIN Team AS G ON T.team_id = G.id
 JOIN lnkPersonToTeam AS l ON l.team_id = G.id
WHERE T.org_id = :current_contact->org_id
 AND T.finalclass IN ('UserRequest', 'Incident')
 AND l.person_id = :current_contact->id

扩展到子组织的工单

另一个使用场景是将 “Power Portal user” 的工单可见性扩展到其子组织的工单：

SELECT Ticket AS T
 JOIN Organization AS root ON T.org_id = root.id
 JOIN Organization AS child ON child.parent_id BELOW root.id
WHERE T.org_id = :current_contact->org_id
 AND T.finalclass IN ('UserRequest', 'Incident')

限制为允许的组织（不级联）

如何防止具有允许组织的门户用户查看其允许组织的子组织的工单：

默认情况下，iTop 会级联用户允许组织的子组织的访问权限。在 3.1.0 中，没有直接方法阻止此行为。
以下 OQL 范围是门户用户严格限制在其允许组织的变通方法。
注意：这样做将阻止没有允许组织的门户用户查看任何工单

SELECT Ticket AS T
 JOIN Organization AS O ON T.org_id=O.id
 JOIN URP_UserOrg AS AO ON AO.allowed_org_id=O.id
 JOIN USER AS U ON AO.userid = U.id
WHERE U.contactid = :current_contact_id
 AND T.finalclass IN ('UserRequest', 'Incident')

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

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

Docs: 门户 - 在表单中定位附件

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

本文档介绍如何在 iTop 门户表单中自定义附件的位置。更多详细内容请参考 iTop 官方文档。

实现方法

在表单的 twig 中定义一个额外字段，该字段将被识别为放置附件的位置：

<div class="form_field" data-field-id="attachments_plugin" data-field-plugin="AttachmentPlugIn" data-field-opened="true"/>

注意 data-field-opened="true" 参数，用于强制附件默认打开或关闭。

完整 twig 示例

<module_designs>
 <module_design id="itop-portal">
 <forms>
 <form id="ticket-edit" _delta="must_exist">
 <twig _delta="redefine">
 <div class="row">
 <div class="col-sm-7">
 <fieldset>
 <legend>{{'Ticket:baseinfo'|dict_s}}</legend>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="title" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="service_id" data-field-flags="read_only"/>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="caller_id" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="servicesubcategory_id" data-field-flags="read_only"/>
 </div>
 <div class="col-sm-12">
 <div class="form_field" data-field-id="description" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="solution" data-field-flags="read_only"/>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="user_satisfaction" data-field-flags="read_only"/>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="user_comment" data-field-flags="read_only"/>
 </div>
 </fieldset>
 </div>
 <div class="col-sm-5">
 <fieldset>
 <legend>{{'Ticket:Type'|dict_s}} &amp; {{'Ticket:date'|dict_s}}</legend>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="status" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="impact" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="urgency" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="priority" data-field-flags="read_only"/>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="start_date" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="last_update" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="resolution_date" data-field-flags="read_only"/>
 <div class="form_field" data-field-id="agent_id" data-field-flags="read_only"/>
 </div>
 </fieldset>
 </div>
 </div>
 <div>
 <div class="form_field" data-field-id="attachments_plugin" data-field-plugin="AttachmentPlugIn" data-field-opened="true"/>
 <div class="form_field" data-field-id="contacts_list"/>
 <div class="form_field" data-field-id="public_log"/>
 </div>
 </twig>
 </form>
 </forms>
 </module_design>
</module_designs>
</itop_design>

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

版本：3_2_0/customization/portal_howto_move_attachment.txt · Last modified: 2025/10/10 15:21 by 127.0.0.1

Docs: 门户：为不同客户创建工单

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

本文档介绍如何在 iTop 门户中允许用户为其他客户创建工单。更多详细内容请参考 iTop 官方文档。

目标

在现有的 iTop 门户（itop-portal 或任何其他门户）中，我们希望允许某些用户为自己以外的人创建工单。

假设我们有一个或创建一个新的配置文件 Business partner user，将其分配给这些用户。

范围（Scopes）

这些用户需要能够看到：

他们需要为其创建工单的所有组织
他们需要为其创建工单的所有联系人
他们需要在其上创建工单的所有服务
等等

<class id="Organization">
 <scopes>
 <scope id="portal-partner-user" _delta="define">
 <oql_view><![CDATA[SELECT Organization]]></oql_view>
 <allowed_profiles>
 <allowed_profile id="Business partner user"/>
 </allowed_profiles>
 </scope>
 </scopes>
</class>
<class id="Contact">
 <scopes>
 <scope id="portal-partner-user" _delta="define">
 <oql_view><![CDATA[SELECT Contact]]></oql_view>
 <allowed_profiles>
 <allowed_profile id="Business partner user"/>
 </allowed_profiles>
 </scope>
 </scopes>
</class>
<class id="Service">
 <scopes>
 <scope id="portal-partner-user" _delta="define">
 <oql_view><![CDATA[SELECT Service]]></oql_view>
 <allowed_profiles>
 <allowed_profile id="Business partner user"/>
 </allowed_profiles>
 </scope>
 </scopes>
</class>
<!-- 以及其他类如 ServiceSubcategory、Ticket 等 -->

砖块（Brick）

这些用户需要能够访问一个新的 BrowseBrick，用于选择客户合同（CustomerContracts）：

<brick id="new-request-for-partner" xsi:type="Combodo\iTop\Portal\Brick\BrowseBrick" _delta="define">
 <active>true</active>
 <width>6</width>
 <rank>
 <default>11</default>
 </rank>
 <title>
 <default>Brick:Portal:NewRequest:Title</default>
 </title>
 <description>Brick:Portal:NewRequest:Title+</description>
 <decoration_class>
 <default>fc fc-new-request fc-2x</default>
 </decoration_class>
 <levels>
 <level id="1">
 <class>Organization</class>
 <tooltip_att>description</tooltip_att>
 <title>Class:Organization</title>
 <actions>
 <action id="drilldown" xsi:type="drilldown"/>
 </actions>
 <levels>
 <level id="1">
 <oql><![CDATA[SELECT CustomerContract]]></oql>
 <parent_att>org_id</parent_att>
 <name_att>name</name_att>
 <tooltip_att>service_id_friendlyname</tooltip_att>
 <title>Class:CustomerContract</title>
 <actions>
 <action id="create_from_this" xsi:type="create_from_this">
 <class>UserRequest</class>
 <icon_class>fc fc-new-request fc-1-6x fc-flip-horizontal</icon_class>
 <rules>
 <rule id="contact-to-userrequest"/>
 <rule id="contract-to-userrequest"/>
 </rules>
 </action>
 <action id="view" xsi:type="view"/>
 </actions>
 <levels/>
 </level>
 </levels>
 </level>
 </levels>
 <browse_modes>
 <availables>
 <mode id="list"/>
 </availables>
 <default>list</default>
 </browse_modes>
 <security>
 <allowed_profiles><![CDATA[SELECT URP_Profiles WHERE name = 'Business partner user']]></allowed_profiles>
 </security>
 <data_loading>auto</data_loading>
</brick>

表单（Form）

创建或修改工单创建表单，以允许选择请求人和服务子类别：

<form id="ticket-create">
 <twig _delta="redefine">
 <div class="row">
 <div class="col-sm-9">
 <div class="row">
 <div class="col-sm-6">
 <div class="form_field" data-field-id="service_id" data-field-flags="mandatory"/>
 <div class="form_field" data-field-id="impact"/>
 </div>
 <div class="col-sm-6">
 <div class="form_field" data-field-id="servicesubcategory_id" data-field-flags="mandatory"/>
 <div class="form_field" data-field-id="urgency"/>
 </div>
 </div>
 <div class="row">
 <div class="col-sm-12">
 <div class="form_field" data-field-id="title"/>
 </div>
 </div>
 </div>
 <div class="col-sm-3">
 <div class="form_field" data-field-id="service_details"/>
 </div>
 </div>
 <div>
 <div class="form_field" data-field-id="description"/>
 <div class="form_field" data-field-id="contacts_list"/>
 </div>
 </twig>
 </properties>
</form>

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

版本：3_2_0/customization/portal_howto_ticket_multi_org.txt · Last modified: 2025/08/12 15:12 by 127.0.0.1