自定义模块   

ServiceDesk Plus 附带了多个内置模块（如请求、变更、资产等）及其默认配置（如状态、优先级矩阵、关闭代码等）。但是，贵组织的需求可能需要超出这些默认模块和配置范围的实体、字段和工作流。

在这种情况下，您可以使用 自定义模块 创建您自己的模块和配置，以及为现有模板创建子表单和子实体。

所需角色：SDAdmin

自定义模块的优势  

• 构建符合您业务流程的模块。
• 创建自定义表单和子实体以收集更多信息。
• 导入数据并基于收集的记录生成报表。
• 设置自动化规则以简化工作流。

自定义模块的类型 

您可以创建四种类型的自定义模块：Web 选项卡、配置、子表单和子实体。

创建自定义模块后，您就可以开始向其中添加相关数据。输入到自定义模块中的信息会被收集并存储为记录。

创建自定义模块     

步骤 1：添加详细信息

• 启用高级功能

步骤 2：添加字段

步骤 3：定义并自定义表单布局

步骤 4：配置权限

步骤 5：添加子实体

步骤 6：创建自定义操作

步骤 7：配置字段和表单规则 

步骤 8：发布自定义模块

步骤 1：添加详细信息 

• 前往 管理 > 开发者空间 > 自定义模块。
• 单击工具栏中的 新建。
• 输入以下详细信息并单击 保存： 

*必填字段  

协作 

使用配置页面右上角的 协作，与多个管理员建立连接并共同配置模块。 

保存 新建自定义模块 表单后，将显示以下部分。

高级 功能  （仅限 Web 选项卡） 

为 Web 选项卡启用高级功能以增强其能力。

某些功能在启用后可进一步配置。要编辑此类配置，请将鼠标悬停在该功能上并单击 编辑。    

选择所需功能后，单击 下一步。 

步骤 2：添加字段 

在 字段列表 中，您可以添加收集信息和在自定义模块中创建记录所需的字段。

• 单击 新建字段。
• 在 新建字段 侧滑面板中，输入以下详细信息：
  • 从侧滑面板顶部的下拉列表中选择字段类型。 

• 配置字段属性（如字段名称、默认值、字符长度等）。字段属性会根据所选字段类型显示。有关配置的更多详细信息，请参阅此处。
• 单击 保存并新建 以保存当前字段并创建新字段。
• 添加完所有字段后，单击 保存。

步骤 3：定义并自定义表单布局 

添加并自定义区块和字段

添加子表单

编辑和删除表单元素

在 表单自定义器 中，您可以定义自定义模块的表单布局。您可以添加区块、字段和子表单，并自定义它们各自的样式属性。

您可以通过拖放操作重新排列表单中的区块、字段和子表单。

在左侧窗格的可用字段和子表单下，您将看到在 字段列表 下添加的字段、默认子表单以及已发布的自定义子表单列表。 

添加 并自定义区块和字段 

默认情况下，表单布局中会添加一个双列区块。您可以根据需要添加更多区块和字段。

添加区块

• 单击左侧窗格中的加号图标 。
• 拖动一种区块类型并将其放到画布上。
• 单击返回图标 以返回可用字段/子表单列表。 

自定义区块

要自定义区块，

• 将鼠标悬停在区块上。
• 单击编辑图标 。
• 在 属性 选项卡中，提供区块名称和帮助文本内容。 

• 要自定义区块样式，请转到 自定义 选项卡。
• 在 区块 下，为区块配置字体系列、字号、字体颜色、字重和背景色。
• 在 标签 下，为字段标签配置位置、字体系列、字号、字体颜色、字重和背景色。
• 单击 保存。

添加字段

从左侧窗格中，将所需字段拖到目标区块中的目标占位符处。  

要添加新字段， 

• 单击左侧窗格中的加号图标。
• 将字段类型拖到画布上。
• 在侧滑面板中的 属性 选项卡里，配置字段属性并单击 保存。若要更改字段类型，请使用侧滑面板顶部的下拉列表。
• 字段属性会根据字段类型而有所不同。

*必填字段

自定义字段样式

在侧滑面板中的 自定义 选项卡内，您可以自定义字段样式。

• 如有需要，可为字段配置字号、字体系列、字体颜色和背景色。
• 单击侧滑面板顶部的 预览 以预览字段样式。
• 单击 保存。 

添加 子表单 

• 将所需子表单拖到画布上。
• 按如下方式配置子表单属性：
  • 如有需要，可编辑自定义子表单的 API 名称。创建自定义模块后，您将无法再编辑该名称。 

• 指定子表单中允许的最大记录数。
• 指定子表单的显示格式：表单（一次采集一条结构化记录）或 表格（以行格式采集多条记录）。
• 单击 保存。 

编辑 表单元素

• 将鼠标悬停在所需的区块、字段或子表单上。
• 单击编辑图标 以编辑其属性。 

您也可以从 字段列表 选项卡编辑字段属性。单击所需字段名称旁边的编辑图标并编辑详细信息。

移除表单元素  

• 将鼠标悬停在所需的区块、字段或子表单上。
• 单击删除图标 并单击 确定。
• 您将在左侧窗格中看到被移除的字段和区块。 

删除字段   

要删除自定义模块中的字段，

• 转到 字段列表 选项卡。
• 单击所需字段旁边的删除图标 。
• 单击 删除。

配置完表单布局后，单击 表单自定义器 选项卡底部的 下一步。

步骤 4：配置权限 （仅限 Web 选项卡和自定义配置）

在 权限 选项卡中，您可以设置用户条件来定义自定义模块的权限。

记录级权限

• 选择 所有记录 以允许用户查看该自定义模块的所有记录。
• 选择 关联记录 以允许用户仅访问自己的记录。  

模块级权限

• 对于 Web 选项卡，设置条件以控制哪些用户可以在自定义模块中添加、编辑、删除或查看记录。您可以为每项操作单独设置权限，也可以为所有操作统一设置权限。

创建自定义模块的用户将拥有完全访问权限，无论其是否满足任何条件。

• 对于自定义配置，只能基于用户角色限制访问。

完成所有必要配置后，单击 保存。 

步骤  5：添加子实体 （仅限 Web 选项卡）

在 子实体 中，您可以添加 Web 选项卡所需的子实体。

您也可以创建自己的子实体。查看方法。

• 在左侧窗格中，您会看到默认子实体和已发布的自定义子实体列表。
• 将所需子实体从左侧窗格拖到画布上。
• 在侧滑面板中，输入以下详细信息：
  • API 名称：如有需要，可编辑自定义子实体的 API 名称。 

• 允许的最大记录数 *：设置可在子实体中创建的最大记录数。
  • 对于 任务、工作日志、清单、提醒 和自定义子实体，最多可允许 100 条记录。
  • 对于 评论 和 通知，最多可允许 1000 条记录。
• 配置项会根据所选子实体显示：

● 自定义子实体
● 任务
● 评论
● 通知
● 工作日志
● 清单
● 提醒

• （ 仅限自定义子实体）权限：在 权限 选项卡中，您可以基于 Web 选项卡权限（模块级权限）定义自定义子实体的权限。
• 任务 ：允许技术人员将工作拆分为更小的可执行项、分配责任并跟踪其进度。
  • 按如下方式配置 任务 及其表单向技术人员显示的方式：

• 评论：允许用户/技术人员相互协作并分享更新。
  对于交互式评论，您可以启用提及、表情回应和回复。  

• 通知 ：在记录详情页面中显示为 对话。
  用户可以在“对话”中查看与记录相关的电子邮件和系统生成的通知，并可回复电子邮件。 

• 提醒 ：允许用户为记录中的关键操作安排提醒电子邮件。 

• 工作 日志：允许技术人员记录在记录整个生命周期内花费的总时间，并计算其成本。
  按如下方式配置工作日志添加表单的显示或行为： 

• 清单 ：允许用户将一组必须在关闭记录之前完成的项目与记录相关联。 

例如，在一条入职记录中，清单可包含设置笔记本电脑、创建电子邮件账户和分配访问权限等任务。只有在所有任务都被勾选完成后，该记录才能关闭。

• 添加完所有所需子实体后，单击“子实体”选项卡底部的 保存。  

编辑子实体

• 要编辑子实体属性，请将鼠标悬停在所需子实体上，然后单击 编辑子实体 。
• 要编辑自定义子实体，请单击子实体标题旁边的 编辑布局。 

移除子实体  

要移除子实体，请将鼠标悬停在其上并单击删除图标 。您将在左侧窗格中看到被移除的子实体。

步骤 6： 创建自定义操作（仅限 Web 选项卡）

使用 自定义操作，您可以为 Web 选项卡中的常用操作配置个性化操作和快捷方式。

这些操作包括：

自定义操作将显示在列表视图工具栏和详情页工具栏中的 操作 下。

除了您创建的自定义操作外，该选项卡还会列出自定义模块支持的 默认操作，例如通过表单添加和编辑记录、查看历史记录和对话。根据在 详细信息 选项卡下启用的功能，列表中还会显示其他操作。

要创建自定义操作，

• 单击 新建。
• 在 新建自定义操作 侧滑面板中，输入以下详细信息并单击 保存。 

*必填

步骤 7： 定义字段和表单规则（仅限 Web 选项卡）

在 字段和表单规则 选项卡中，您可以配置规则，以根据用户输入动态修改模板表单。

当 Web 选项卡表单中发生以下任一/全部事件时，可将这些操作配置为执行：

要配置规则，

• 转到所需事件选项卡并单击 创建新规则。
• 输入规则名称，并选择所需用户、规则条件和表单事件。
• 使用下拉列表和逻辑运算符定义规则执行的字段条件。
• 选择当满足条件时要执行的字段操作。
• 单击 保存。 

有关更多信息，请单击此处。 

自定义模块状态   

使用配置页面右上角的状态 下拉列表来标记自定义模块的状态并控制其可访问性。 

可用状态包括：

（仅限 Web 选项卡）发布自定义模块后， 您可以在 详情自定义器 选项卡下为记录详情页创建不同布局。要了解如何自定义布局，请单击此处。

编辑自定义模块    

您只能编辑处于 草稿 状态的自定义模块。

• 转到所需自定义模块的配置页面。
• 将 发布 或 暂停 切换为 草稿，然后编辑所需详细信息。

删除自定义模块 

要删除自定义模块，

• 前往 自定义模块。
• 在列表视图中，单击自定义模块名称旁边的 操作 。
• 单击 删除。

访问自定义模块      

您可以从导航窗格访问 Web 选项卡。要了解有关管理 Web 选项卡中记录的更多信息，请单击此处。

要访问自定义配置，请前往 管理 > 自定义 > 自定义 配置。每个自定义配置都会在列表视图中显示为选项卡。要了解有关管理自定义配置的更多信息，请单击此处。

您可以从使用它们的 Web 选项卡和自定义配置中访问子表单和子实体。

列表视图操作 

在自定义模块列表视图中，您可以执行以下操作：

• 查看所有自定义模块
• 编辑/删除自定义模块
• 移动到 ESM 目录
• 搜索自定义模块
• 管理列表视图
• 查看历史记录

查看所有自定义模块 

在列表视图中，您将看到所有自定义模块的列表。使用模块和状态筛选器可显示特定类型和状态的自定义模块。

单击 + 新建 以创建自定义模块。 

编辑/删除自定义模块 

• 单击所需自定义模块旁边的 操作。
• 单击 编辑 或 删除。

移动到 ESM 目录 （仅限自定义配置）

• 单击所需自定义配置旁边的 操作。
• 单击 移动到 ESM 目录。 

如果某个自定义配置包含门户专用的引用实体字段，则无法将其移动到 ESM 目录。

搜索自定义模块 

单击顶部的 搜索，并在所需列中使用关键字搜索自定义模块。

管理列表视图 

从顶部的下拉列表中选择每页要显示的记录数。您还可以使用导航按钮跳转到不同的索引页面。

 查看历史记录 

• 单击右上角的 查看历史记录 以查看对自定义模块执行的所有操作详情。
• 您可以按操作和字段筛选详情。
• 使用 选择日期 下拉列表搜索特定时间段内的操作。 

附加资源 

管理 Web 选项卡

管理自定义配置