# 入门

> 添加一个小部件只需不到一分钟。本页说明小部件位于何处、如何添加，以及如何安全地使用它们。

Source: https://widgets.doorsnext.com/zh/get-started/

## 开始之前
- IBM Engineering Lifecycle Management 7.x，并配备 IBM DOORS Next（适用于大多数小部件）或任意 ELM 应用程序（适用于 User Audit）。
- 现代浏览器：Google Chrome、Microsoft Edge、Mozilla Firefox 或 Safari。
- 由管理员在 ELM 服务器上注册的 SmarterWidgets 目录。请[联系 SmarterProcess](https://widgets.doorsnext.com/zh/about/#contact) 获取访问权限。
- 您平时的 DOORS Next 权限。小部件只能执行您本人有权执行的操作。

## 将小部件添加到 DOORS Next 模块
1. 在 DOORS Next 中打开一个模块。
2. 打开页面右侧的 ELM Mini Dashboard（**Show Mini Dashboard**，显示迷你仪表板）。
3. 单击 **Add Widget**（添加窗口小部件），选择 SmarterWidgets 目录，然后选择所需的小部件。目录会显示每个小部件的简短说明和预览。
4. 小部件出现在 ELM Mini Dashboard 中，即可使用。下次访问时它仍会保留在那里。

在整个服务器范围内工作的小部件（例如 Baseline Archiver 或 User Audit）也可以用同样的方式添加到其他 ELM 应用程序的 ELM Mini Dashboard 中。

## 在变更集中工作
> **我们建议在 DOORS Next 变更集中运行每一个会更改数据的小部件。** 如果某次运行产生了您不想要的更改，只需废弃该变更集，任何内容都不会进入流。请在检查结果之后再交付变更集。运行生成的 Excel 变更报告可以帮助您完成这项审查。

## 每个小部件的结构
所有小部件都采用相同的布局，因此只要熟悉其中一个，就能掌握全部：

- **标题栏**：显示小部件名称，以及用于刷新上下文和重置小部件的按钮。
- **说明**：用一两句话解释小部件的作用，并带有可折叠的 **How it works**（工作原理）面板。
- **工作区域**：通常为 **Module**（整个已打开的模块）和 **Selection**（您选中的工件），每个区域都有一个清晰的主按钮。
- **Execution Status**（执行状态）：显示进度、**Stop**（停止）按钮、以汇总磁贴呈现的结果、无法更改的项目列表（带 **Retry**（重试））以及变更报告。
- **页脚**：显示版本号和发布日期。

## 设置
每个小部件在小部件菜单的 **Edit**（编辑）下都有少量设置，例如批次大小，或者通知是否显示在 DOORS Next 页面上方。您的设置会保存在浏览器中。大多数用户从不需要更改这些设置。

## 更新
当小部件有新版本可用时，小部件标题栏中会出现蓝色的 **New Version Available**（有新版本可用）标签。将鼠标悬停在标签上即可查看更新内容。本文档中每个小部件的页面会列出其最新版本的变更内容。